<!DOCTYPE html>
<html lang="en">
    <head>
            <meta charset="utf-8">
            <meta http-equiv="X-UA-Compatible" content="IE=edge">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            <meta content="Bmob,BmobCloud,bomb,BaaS,mBaaS,PaaS,Serverless,FaaS,Function as a Service,Backend as a Service,serverless computing,cloud function,后端云,bmob后端云,小程序云,小程序后端,云数据库,云存储,文件存储,云函数,云端代码,定时任务,游戏后端,游戏云,用户系统,无服务器函数,移动开发,app开发,小程序开发,云端一体化,互联网中间件" name="keywords"/>
            <meta content="国内首家专注于移动应用Serverless云服务的平台,Bmob后端云让移动开发更简单,全方位一体化的后端服务平台" name="description"/>
            
            
            
            <link rel="shortcut icon" href="../../../img/favicon.ico">
        
        <script type="text/javascript" src="//game.bmob.cn/static/doc_union.js"></script>
            <!--
            <title>开发文档 - Bmob文档中心</title>
            -->
            <title>数据存储 &middot; REST API – Bmob后端云 </title>        
            
            <link href="../../../css/bootstrap-custom.min.css" rel="stylesheet">
            <link href="../../../css/font-awesome-4.5.0.css" rel="stylesheet">
            <link href="../../../css/base.css" rel="stylesheet">
            <link rel="stylesheet" href="../../../css/highlight.css">
            <link href="../../../css/agate.css" rel="stylesheet">
            <link href="../../../css/custom.css" rel="stylesheet" id="custom">
    </head>

    <body >

        <div class="navbar navbar-fixed-top" role="navigation">
    <div class="main-nav">
        <!-- Collapsed navigation -->
        <div class="navbar-header">
            <a class="navbar-brand" href="../../..">
                <!--Bmob文档中心-->
                <img src="../../../img/logo.png" alt="">
            </a>
        </div>

        <!-- Expanded navigation -->
        <div class="navbar-collapse collapse">

          <ul class="nav navbar-nav">
            
              <li class="pull-left">
                
					<a href="../../..">文档首页</a>
                
              </li>
            
              <li class="pull-left active">
                
					<!--<a href="">数据服务</a>-->
					<li class="dropdown active">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">数据服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../android/">Android</a>
                                </li>
                            
                            
								<li >
									<a href="../../ios/">iOS</a>
                                </li>
                            
                            
								<li >
									<a href="../../csharp/">C#</a>
                                </li>
                            
                            
								<li >
									<a href="../../php/">PHP</a>
                                </li>
                            
                            
								<li >
									<a href="../../go/">GO</a>
                                </li>
                            
                            
								<li class="active">
									<a href="../">REST API</a>
                                </li>
                            
                            
								<li >
									<a href="../../wechat_app_new/rm/">JavaScript</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../cocos2d_x/">Cocos2D-X</a>
                                </li>
							
                            
								<li >
									<a href="../../wechat_app/">小程序</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../wechat_app_new/">快应用</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../wechat_app_new/">Nodejs</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../wechat_app_new/">Cocos Creator</a>
                                </li>
							
                            
								<li >
									<a href="../../wechat_app_new/rm/">小程序(新)</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../kotlin/">Kotlin</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../python/">Python</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../cloud_function/android/">云函数</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">云函数 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../cloud_function/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/java/">Java</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/python/">Python</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/csharp/">C#</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/restful/">REST API</a>
                                </li>
							
                            
								<li >
									<a href="../../../cloud_function/web/">Web</a>
                                </li>
                            
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../sms/android/">短信服务</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">短信服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../sms/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/restful/">REST API</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="">游戏实时后端</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">游戏实时后端 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../../game/unity/quick_start/">Unity</a>
                                </li>
                            
                            
								<li >
									<a href="../../../game/cocos_creator/quick_start/">Cocos Creator</a>
                                </li>
                            
                            
								<li >
									<a href="../../../game/wechat_games/quick_start/">微信小游戏</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../../game/cloud_function/develop_doc/">云函数</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../game/classic_case/">经典案例</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="">即时通讯</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">即时通讯 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../../im/android/">Android</a>
                                </li>
                            
                            
								<li >
									<a href="../../../im/ios/">iOS</a>
                                </li>
                            
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../push/android/">推送服务</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">推送服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../push/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/restful/">REST API</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../other/common_problem/">其他</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">其他 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../other/common_problem/">常见问题</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/error_code/">错误码</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/data_safety/">数据安全</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/bql/">BQL</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li>
                  <a href="https://www.bmob.cn/repository/index" target="_blank">知识库</a>
              </li>
              <li>
                  <a href="http://doc.bmob.cn/video/index.html" target="_blank">视频教程</a>
              </li>
            </ul>
            
        </div>
    </div>
</div>

        <div class="pagebody" id="main-wrapper">
            <div class="sidebar">
                <div class="bs-sidebar hidden-print affix well" role="complementary">

	
		
	
		
				
				
				
				
				
				
					<div class="code-title">REST API</div>
				
				
				
				
				
				
				
				
				
				
		
	
		
				
				
				
				
				
				
				
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
				
				
		
	


	<ul class="nav bs-sidenav">
		
			
		
			
				
					
						
					
						
					
						
					
						
					
						
					
						
							
								
									<li class="">
										<a class="itm-l1" href="../">快速入门</a>
										
									</li>
								
									<li class="active">
										<a class="itm-l1" href="./">开发文档</a>
										
										<ul class="nav">
											
											<li class="active "><a href="#_1">简介</a>
												
											</li>
												
											<li class=""><a href="#_2">案例源码</a>
												
											</li>
												
											<li class=""><a href="#_3">请求格式</a>
												
											</li>
												
											<li class=""><a href="#_4">响应格式</a>
												
											</li>
												
											<li class=""><a href="#_5">快速参考</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_6">对象快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_7">用户快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_8">文件管理快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#acl">ACL和角色管理快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#app">app服务快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_9">数据表快速参考</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_10">其它功能快速参考</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_11">对象</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_12">对象格式</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_13">数据类型</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_14">添加数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_15">更新数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_19">删除数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_21">批量数据操作</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_22">查询</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_23">查询单条数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_24">查询多条数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_25">条件查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_28">复合查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_29">查询结果计数</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_30">查询指定列</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_31">统计相关的查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#bql">BQL查询</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_39">数组</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_40">添加数组数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_41">更新数组数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_43">删除数组数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_44">查询数组数据</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_45">数据关联</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_46">关联对象</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#pointer">Pointer的使用</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#relation">Relation的使用</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_47">用户管理</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_48">属性</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_49">注册用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_50">使用手机号码一键注册或登陆</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_51">登录用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_52">获取当前用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_53">检查用户的登录是否过期</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_54">更新用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_55">删除用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_56">查询用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_57">密码重置</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_60">邮箱验证</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_61">用户账户连接</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_65">文件管理</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_66">整个文件上传</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_67">删除文件</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_68">批量删除文件</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#acl_1">ACL和角色</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#acl_2">ACL的格式</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_69">角色和相关操作</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_76">地理位置</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_77">创建地理位置对象</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_78">查询地理位置信息</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#app_1">app服务</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#app_2">获取app信息</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#app_3">创建新的app</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#app_4">修改app信息</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_79">数据表</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#app_5">获取app表的信息</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_80">表支持的数据类型</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_81">创建一个表</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_82">修改表的结构</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_83">删除表</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_84">获取服务器时间</a>
												
											</li>
												
											<li class=""><a href="#_85">错误码</a>
												
											</li>
												
										</ul>
										
									</li>
								
							
						
					
						
					
						
					
						
					
						
					
						
					
						
					
						
					
						
					
						
					
				
			
		
			
		
			
		
			
		
			
		
			
		
			
		
	</ul>
</div>
            </div>
            <div class="content" role="main">
                <div class="wrap">
                    

<h2 id="_1">简介<a class="headerlink" href="#_1" title="Permanent link">&para;</a></h2>
<p>只要你的设备，你使用的语言能够发送HTTP请求，那么就可以用来和<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>进行数据交互，你可以使用REST API做很多事情,比如:</p>
<ul>
<li>一个移动网站可以通过C、Java、Python、PHP、C#等甚至任何语言来获取<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>上的数据。</li>
<li>一个网站可以展示来自<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>的数据。</li>
<li>你可以上传大量的数据，随后可以被一个移动App读取。</li>
<li>你可以下载最近的数据来进行你自定义的分析统计。</li>
<li>使用任何语言写的程序都可以操作<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>上的数据。</li>
<li>如果你不再需要使用<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>，你可以导出你所有的数据。</li>
</ul>
<h2 id="_2">案例源码<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<p>这里提供一些开发者写的其他语言调用RestApi的源码或者核心代码。</p>
<p>JAVA访问RestApi：<a href="https://github.com/bmob/bmob-java-sdk/tree/v3/javasdkdemo">https://github.com/bmob/bmob-java-sdk/tree/v3/javasdkdemo</a></p>
<p>PHP访问RestApi：<a href="http://docs.bmob.cn/data/PHP/a_faststart/doc/index.html">http://docs.bmob.cn/data/PHP/a_faststart/doc/index.html</a></p>
<p>AS3.0访问RestApi：<a href="http://wenda.bmob.cn//?/question/193">http://wenda.bmob.cn//?/question/193</a></p>
<h2 id="_3">请求格式<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h2>
<p>对于POST和PUT请求，请求的主体必须是JSON格式,而且HTTP请求头的 <strong>Content-Type</strong> 需要设置为 <strong>application/json</strong> 。</p>
<p>用户验证是通过HTTP请求头来进行的, <strong>X-Bmob-Application-Id</strong> 头表明你正在访问的是哪个App程序, 而 <strong>X-Bmob-REST-API-Key</strong> 头是用来授权的。在下面的例子中，你必须使用正确的key替换Your Application ID和Your REST API Key才能正常地发出Curl请求。</p>
<h2 id="_4">响应格式<a class="headerlink" href="#_4" title="Permanent link">&para;</a></h2>
<p>对于所有REST API请求的响应内容体都是一个JSON对象.</p>
<p>一个请求是否成功是由HTTP状态码表明的， 一个2XX的状态码表示成功，而一个4XX表示请求失败。当一个请求失败时响应的主体仍然是一个JSON对象，但是总会包含code和error这两个字段，你可以用它们来进行调试。举个例子，如果保存一个对象的时候，尝试用不允许的Key，比如包含下划线的_name的话，就会得到如下请求失败的响应信息:</p>
<pre><code>{
    &quot;code&quot;: 105,
    &quot;error&quot;: &quot;invalid field name: bl!ng&quot;
}
</code></pre>

<h2 id="_5">快速参考<a class="headerlink" href="#_5" title="Permanent link">&para;</a></h2>
<p>API 访问需要在 https://api2.bmob.cn 域名下，相对路径前缀 /1/ 表明现在使用的是第 1 版的 API。</p>
<h3 id="_6">对象快速参考<a class="headerlink" href="#_6" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/classes/TableName</td>
<td align="left">POST</td>
<td align="left">添加数据</td>
</tr>
<tr>
<td align="left">/1/classes/TableName/objectId</td>
<td align="left">PUT</td>
<td align="left">更新数据</td>
</tr>
<tr>
<td align="left">/1/classes/TableName/objectId</td>
<td align="left">DELETE</td>
<td align="left">删除数据</td>
</tr>
<tr>
<td align="left">/1/batch</td>
<td align="left">POST</td>
<td align="left">批量操作数据</td>
</tr>
<tr>
<td align="left">/1/classes/TableName/objectId</td>
<td align="left">GET</td>
<td align="left">查询数据</td>
</tr>
<tr>
<td align="left">/1/cloudQuery</td>
<td align="left">GET</td>
<td align="left">使用BQL查询</td>
</tr>
</tbody>
</table>
<h3 id="_7">用户快速参考<a class="headerlink" href="#_7" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/users</td>
<td align="left">POST</td>
<td align="left">用户注册、使用手机号注册登录、第三方注册登录</td>
</tr>
<tr>
<td align="left">/1/login</td>
<td align="left">GET</td>
<td align="left">登录</td>
</tr>
<tr>
<td align="left">/1/users/objectId</td>
<td align="left">GET</td>
<td align="left">获取当前用户、查询用户</td>
</tr>
<tr>
<td align="left">/1/users/objectId</td>
<td align="left">PUT</td>
<td align="left">更新用户、第三方连接及断开连接</td>
</tr>
<tr>
<td align="left">/1/users/objectId</td>
<td align="left">DELETE</td>
<td align="left">删除用户</td>
</tr>
<tr>
<td align="left">/1/requestPasswordReset</td>
<td align="left">POST</td>
<td align="left">密码重置</td>
</tr>
<tr>
<td align="left">/1/resetPasswordBySmsCode/smsCode</td>
<td align="left">PUT</td>
<td align="left">短信密码重置</td>
</tr>
<tr>
<td align="left">/1/updateUserPassword/objectId</td>
<td align="left">POST</td>
<td align="left">旧密码更新密码</td>
</tr>
<tr>
<td align="left">/1/requestEmailVerify</td>
<td align="left">POST</td>
<td align="left">邮箱验证</td>
</tr>
</tbody>
</table>
<h3 id="_8">文件管理快速参考<a class="headerlink" href="#_8" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/2/files/fileName</td>
<td align="left">POST</td>
<td align="left">文件上传</td>
</tr>
<tr>
<td align="left">/2/files/cdnName/url</td>
<td align="left">DELETE</td>
<td align="left">删除文件</td>
</tr>
<tr>
<td align="left">/2/cdnBatchDelete</td>
<td align="left">POST</td>
<td align="left">批量删除CDN文件</td>
</tr>
</tbody>
</table>
<h3 id="acl">ACL和角色管理快速参考<a class="headerlink" href="#acl" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/roles</td>
<td align="left">POST</td>
<td align="left">创建角色</td>
</tr>
<tr>
<td align="left">/1/roles/objectId</td>
<td align="left">GET</td>
<td align="left">获取角色</td>
</tr>
<tr>
<td align="left">/1/roles/objectId</td>
<td align="left">PUT</td>
<td align="left">更新角色</td>
</tr>
</tbody>
</table>
<h3 id="app">app服务快速参考<a class="headerlink" href="#app" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/apps</td>
<td align="left">GET</td>
<td align="left">获取所有app信息</td>
</tr>
<tr>
<td align="left">/1/apps/appId</td>
<td align="left">GET</td>
<td align="left">获取特定app信息</td>
</tr>
<tr>
<td align="left">/1/apps</td>
<td align="left">POST</td>
<td align="left">创建新app</td>
</tr>
<tr>
<td align="left">/1/apps/appId</td>
<td align="left">PUT</td>
<td align="left">修改app信息</td>
</tr>
</tbody>
</table>
<h3 id="_9">数据表快速参考<a class="headerlink" href="#_9" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/schemas</td>
<td align="left">GET</td>
<td align="left">获取所有表信息</td>
</tr>
<tr>
<td align="left">/1/schemas/TableName</td>
<td align="left">GET</td>
<td align="left">获取特定表信息</td>
</tr>
<tr>
<td align="left">/1/schemas/TableName</td>
<td align="left">POST</td>
<td align="left">创建表</td>
</tr>
<tr>
<td align="left">/1/schemas/TableName</td>
<td align="left">PUT</td>
<td align="left">修改表</td>
</tr>
<tr>
<td align="left">/1/schemas/TableName</td>
<td align="left">DELETE</td>
<td align="left">删除表</td>
</tr>
</tbody>
</table>
<h3 id="_10">其它功能快速参考<a class="headerlink" href="#_10" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="left">URL</th>
<th align="left">HTTP</th>
<th align="left">功能</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">/1/timestamp</td>
<td align="left">GET</td>
<td align="left">获取服务器时间</td>
</tr>
</tbody>
</table>
<h2 id="_11">对象<a class="headerlink" href="#_11" title="Permanent link">&para;</a></h2>
<h3 id="_12">对象格式<a class="headerlink" href="#_12" title="Permanent link">&para;</a></h3>
<p>通过REST API保存数据需要将对象的数据通过JSON来编码，这个数据是无模式化的（Schema Less）,这意味着你不需要提前标注每个对象上有哪些Key，你只需要随意设置key-value对就可以，Rest API后端会存储它的。</p>
<p>举个例子，假设你正在记录一局游戏的最高分，一个简单的对象可能包含:</p>
<pre><code>{
    &quot;score&quot;: 1337,
    &quot;playerName&quot;: &quot;Sean Plott&quot;,
    &quot;cheatMode&quot;: false
}
</code></pre>

<p>Key必须是字母和数字组成的字符串,Value可以是任何可以JSON编码的东西.</p>
<p>每个对象都有一个类名，你可以通过类名来区分不同的数据，例如，我们可以把游戏得分对象称之为GameScore.我们推荐你使用  <strong>NameYourClassesLikeThis</strong> 和 <strong>nameYourKeysLikeThis</strong> 这样的格式为你的类名和Key命名，这可以使你的代码看起来很漂亮.</p>
<p>当你从<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>中获取对象时，一些字段会被自动加上: createdAt, updatedAt 和 objectId， 这些字段的名字是保留的，你不能自行设置它们，我们上面设置的对象在获取时应该是下面的样子.</p>
<pre><code>{
    &quot;score&quot;: 1337,
    &quot;playerName&quot;: &quot;Sean Plott&quot;,
    &quot;cheatMode&quot;: false,
    &quot;createdAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;updatedAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;objectId&quot;: &quot;e1kXT22L&quot;
}
</code></pre>

<p>createdAt和updatedAt都是UTC时间戳,以ISO 8601标准和毫秒级精度储存:YYYY-mm-dd HH:ii:ss. objectId是一个string,在类中唯一表明了一个对象。</p>
<p>在REST API中class级的在一个资源上的操作只能根据类名来进行，例如，如果类名是GameScore，那么class的URL就是</p>
<pre><code>https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>用户有一个特殊的类级的url:</p>
<pre><code>https://api2.bmob.cn/1/users
</code></pre>

<p>针对于一个特定对象的操作可以通过组织一个URL来做，例如，对GameScore中的一个objectId为e1kXT22L的对象的操作应使用如下URL:</p>
<pre><code>https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_13">数据类型<a class="headerlink" href="#_13" title="Permanent link">&para;</a></h3>
<p>到现在为止我们只使用了可以被标准JSON编码的值，<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>移动客户端SDK库同样支持日期,地理位置数据和指针数据、关系型数据。在REST API中，这些值都被编码了，同时有一个"__type"字段来标识出它们所属的类型，所以如果你采用正确的编码的话就可以读或者写这些字段了。</p>
<p>Date类型包含了一个"iso"字段存储了一个UTC时间戳,以ISO 8601格式和毫秒级的精度来存储时间: YYYY-MM-DDTHH:MM:SS.MMMZ，或者 YYYY-MM-DDTHH:MM:SS</p>
<pre><code>{
    &quot;__type&quot;: &quot;Date&quot;,
    &quot;iso&quot;: &quot;2011-08-21 18:02:52&quot;
}
</code></pre>

<p>Date 与内置的 <strong>createdAt</strong> 字段和 <strong>updatedAt</strong> 字段相结合的时候特别有用，举个例子：为了找到在一个特殊时间创建的对象，只需要将Date编码在一个查询的where条件中:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;createdAt&quot;:{&quot;$gte&quot;:{&quot;__type&quot;:&quot;Date&quot;,&quot;iso&quot;:&quot;2011-08-21 18:02:52&quot;}}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>File类型是在上传后返回的JSON数据再加一个Key为"__Type":"File", 用来保存到数据列为文件类型的值：</p>
<pre><code>{
    &quot;__type&quot;: &quot;File&quot;,
    &quot;group&quot;: &quot;group1&quot;,
    &quot;filename&quot;: &quot;1.xml&quot;,
    &quot;url&quot;: &quot;M00/01/14/sd2lkds0.xml&quot;
}
</code></pre>

<p>更新对象时可以为该对象保存上传后返回的文件信息：</p>
<pre><code>curl -X PUT
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;score&quot;:1337,&quot;playerName&quot;:&quot;Sean Plott&quot;,&quot;file&quot;:{&quot;__type&quot;:&quot;File&quot;,&quot;group&quot;:&quot;group1&quot;,&quot;filename&quot;:&quot;1.xml&quot;,&quot;url&quot;:&quot;M00/01/14/sd2lkds0.xml&quot;
}}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<p>Pointer 类型是在当前对象要指向另一个对象时使用，它包含了 className 和 objectId 两个作为一个指针正确指向的必填值.</p>
<pre><code>{
  &quot;__type&quot;: &quot;Pointer&quot;,
  &quot;className&quot;: &quot;Game&quot;,
  &quot;objectId&quot;: &quot;DdUOIIIW&quot;
}
</code></pre>

<p>指向用户对象的 <strong>Pointer</strong> 的 <strong>className</strong> 为_User, 前面加一个下划线表示开发者不能定义的类名, 而且所指的类是系统内置的。</p>
<p><strong>Relation</strong> 类型被用在多对多的类型上, 移动端的库将使用 <strong>BmobRelation</strong> 作为值, 它有一个 className 字段表示目标对象的类名：</p>
<pre><code>{
  &quot;__type&quot;: &quot;Relation&quot;,
  &quot;className&quot;: &quot;GameScore&quot;
}
</code></pre>

<p>当使用查询时， <strong>Relation</strong> 对象的行为很像是 <strong>Pointer</strong> 的数组, 任何操作针对于 <strong>Pointer</strong> 的数组的 (除了 include) 都可以对 <strong>Relation</strong> 起作用.</p>
<p>当更多的数据类型被加入的时候, 它们都会采用 hashmap <strong>加上一个 type</strong> 字段的形式, 所以你不应该使用type作为你自己的JSON对象的Key。</p>
<h3 id="_14">添加数据<a class="headerlink" href="#_14" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>为了在<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>上创建一个新的对象，应该向class的URL发送一个POST请求，其中内容体应该是包含对象本身的JSON格式。</p>
<p><strong>请求</strong></p>
<ul>
<li>url ：https://api2.bmob.cn/1/classes/TableName</li>
<li>method ：POST</li>
<li>header:</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1 : value1,
  key2 : value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 201 Created</p>
</li>
<li>
<p>location: https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    &quot;createdAt&quot;: create date,
    &quot;objectId&quot;: objectId
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，要创建如上例子中说的对象:</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;score&quot;:1337,&quot;playerName&quot;:&quot;Sean Plott&quot;,&quot;cheatMode&quot;:false}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>当创建成功时，响应的HTTP状态码的返回值是201 Created，而响应的HTTP头部中Location的值是表示刚创建的该对象的URL:</p>
<pre><code>Status: 201 Created
Location: https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<p>响应的主体是一个JSON对象,包含新对象的objectId和createdAt时间戳：</p>
<pre><code>{
    &quot;createdAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;objectId&quot;: &quot;e1kXT22L&quot;
}
</code></pre>

<h3 id="_15">更新数据<a class="headerlink" href="#_15" title="Permanent link">&para;</a></h3>
<h4 id="_16">普通更新<a class="headerlink" href="#_16" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>为了更改一个对象上已经有的数据，你可以发送一个PUT请求到对象相应的URL上，只有你指定的Key的值才会变更为新值，任何你未指定的Key的值都不会更改，所以你可以只更新对象数据的一个子集。</p>
<p><strong>请求</strong></p>
<ul>
<li>url ：https://api2.bmob.cn/1/classes/</li>
<li>
<p>TableName/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1 : value1,
  key2 : value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;updatedAt&quot;: &quot;YYYY-mm-dd HH:ii:ss&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>我们来更改我们对象的一个score的字段:</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;score&quot;:73453}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<p>返回的JSON对象只会包含一个updatedAt字段，表明更新发生的时间：</p>
<pre><code>{
    &quot;updatedAt&quot;: &quot;2011-08-21 18:02:52&quot;
}
</code></pre>

<h4 id="_17">修改对象的某个值<a class="headerlink" href="#_17" title="Permanent link">&para;</a></h4>
<p>如果存储的是JSON对象还可以通过以下形式，只修改JSON对象的特定键值，其body为：</p>
<pre><code>{
  key1.keyOfJson : value1,
  key2.keyOfJson : value2,
  ...
}
</code></pre>

<p>如果你当前行有一列叫userAttibute,保存的是一个JSON 对象，比如是: {"name":"John", "gender":"男"}，那么我们要修改这个对象的gender值就可以通过以下方式实现：</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;userAttibute.gender&quot;:&quot;女&quot;}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h4 id="_18">原子计算器<a class="headerlink" href="#_18" title="Permanent link">&para;</a></h4>
<p>另外，很多应用可能会有需要计数器的功能，比如某条信息被点赞多少次等。Bmob提供了非常便捷的方式来保证原子性的修改某一数值字段的值，body如下，其中value的正负均可。</p>
<p>其中请求的body为：</p>
<pre><code>{
    key1:{&quot;__op&quot;:&quot;Increment&quot;,&quot;amount&quot;:value}
    ...
}
</code></pre>

<p>例如，如果需要让score每次增加1，而并不需要知道其当前的值，可以使用以下请求：</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;score&quot;:{&quot;__op&quot;:&quot;Increment&quot;,&quot;amount&quot;:1}}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_19">删除数据<a class="headerlink" href="#_19" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>为了在<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>上删除一个对象，可以发送一个DELETE请求到指定的对象的URL。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>method ：DELETE</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status:200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>删除GameScore下objectId为e1kXT22L的方法如下：</p>
<pre><code>curl -X DELETE \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h4 id="_20">删除字段的值<a class="headerlink" href="#_20" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>可以在一个对象中删除一个字段，通过接口自定义的Delete操作</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1:{&quot;__op&quot;:&quot;Delete&quot;},
  key2:{&quot;__op&quot;:&quot;Delete&quot;},
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;updatedAt&quot;: &quot;YYYY-mm-dd HH:ii:ss&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>如果要删除GameScore中objectId为e1kXT22L记录的playerName，可进行如下请求。</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;playerName&quot;:{&quot;__op&quot;:&quot;Delete&quot;}}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_21">批量数据操作<a class="headerlink" href="#_21" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>为了减少因为网络通讯次数太多而带来的时间浪费, Bmob提供批量(batch)操作，在一个请求中对多个普通对象进行添加(create)、更新(update)、删除(delete) 操作，上限为50个。在一个批量(batch)请求中每一个操作都有自己对应的方法、路径和主体, 这些参数可以代替你通常使用的HTTP方法. 这些操作会以发送过去的顺序来执行。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/batch</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;requests&quot;: [
          {
            &quot;method&quot;: &quot;POST&quot;,
            &quot;path&quot;: &quot;/1/classes/TableName&quot;,
            &quot;body&quot;: {
              key1: value1,
              key2: value2,
              ...
            }
          },
          {
            &quot;method&quot;: &quot;PUT&quot;,
            &quot;token&quot;: &quot;tokenValue&quot;(具有ACL规则时),
            &quot;path&quot;: &quot;/1/classes/TableName/objectId&quot;,
            &quot;body&quot;: {
              key1: value1,
              ...
            }
          },
          {
            &quot;method&quot;: &quot;DELETE&quot;,
            &quot;token&quot;: &quot;tokenValue&quot;(具有ACL规则时),
            &quot;path&quot;: &quot;/1/classes/TableName/objectId&quot;
          },

          ...

          ]
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>[
(添加对象返回的信息)
  {
    &quot;success&quot;: {
      &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
      &quot;objectId&quot;: &quot;d746635d0b&quot;
    }
  },
  (修改对象返回的信息)
  {
    &quot;success&quot;: {
      &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss
    }
  },
  (删除对象返回的信息)
  {
    &quot;success&quot;: {
      &quot;msg&quot;: &quot;ok&quot;
    }
  }
]
</code></pre>

<p><strong>例子</strong></p>
<p>比如我们要创建一系列的 GameScore 的对象:</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;requests&quot;: [
          {
            &quot;method&quot;: &quot;POST&quot;,
            &quot;path&quot;: &quot;/1/classes/GameScore&quot;,
            &quot;body&quot;: {
              &quot;score&quot;: 1337,
              &quot;playerName&quot;: &quot;Sean Plott&quot;
            }
          },
          {
            &quot;method&quot;: &quot;POST&quot;,
            &quot;path&quot;: &quot;/1/classes/GameScore&quot;,
            &quot;body&quot;: {
              &quot;score&quot;: 1338,
              &quot;playerName&quot;: &quot;ZeroCool&quot;
            }
          }
        ]
      }'
  https://api2.bmob.cn/1/batch
</code></pre>

<p>如果我们要修改用户表的某条记录或者删除某条记录，则用以下方法。</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;requests&quot;: [
          {
            &quot;method&quot;: &quot;PUT&quot;,
            &quot;token&quot;: &quot;pnktnjyb996sj4p156gjtp4im&quot;,
            &quot;path&quot;: &quot;/1/users/51e3a334e4b0b3eb44adbe1a&quot;,
            &quot;body&quot;: {
              &quot;score&quot;: 999999
            }
          },
          {
            &quot;method&quot;: &quot;DELETE&quot;,
            &quot;token&quot;: &quot;pnktnjyb996sj4p156gjtp4im&quot;,
            &quot;path&quot;: &quot;/1/users/51a8a4d9e4b0d034f6159a35&quot;
          }
        ]
      }' \
  https://api2.bmob.cn/1/batch
</code></pre>

<h2 id="_22">查询<a class="headerlink" href="#_22" title="Permanent link">&para;</a></h2>
<p>数据的查询可能是每个应用都会频繁使用的，它提供了多样的方法来实现不同条件的查询，同时它的使用也是非常的简单和方便。</p>
<h3 id="_23">查询单条数据<a class="headerlink" href="#_23" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>当你创建了一个对象时，你可以通过发送一个HTTP GET请求到创建对象成功时返回的HTTP请求头中的Location的URL获取它的内容。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId，可以加上include值，具体形式为：https://api2.bmob.cn/1/classes/TableName/objectId?include=game</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1 : value1,
  key2 : value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    key1:value1,
    key2:value2,
    ...
}
</code></pre>

<p><strong>例子</strong></p>
<p>为了得到我们上面创建的对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<p>返回的主体是一个JSON对象，它包含所有用户提供的field，并且加上系统保留的createdAt,updatedAt和objectId三个Key的值：</p>
<pre><code>{
    &quot;score&quot;: 1337,
    &quot;playerName&quot;: &quot;Sean Plott&quot;,
    &quot;cheatMode&quot;: false,
    &quot;skills&quot;: [
        &quot;pwnage&quot;,
        &quot;flying&quot;
    ],
    &quot;createdAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;updatedAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;objectId&quot;: &quot;e1kXT22L&quot;
}
</code></pre>

<p>当获取的对象有指向其子对象的Pointer类型指针Key时，你可以加入inclue选项来获取指针指向的子对象。按上面的实例，如果GameScore对象有一个game的Key为Pointer类型，并指向了Game游戏对象，那么可以通过GameScore的game这个Key来获取指向的一个Game对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'include=game' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<p>返回的主体是一个JSON对象包含GameScore的所有Key，并有game这个Pointer的Key被扩展为一个Game对象:</p>
<pre><code>{
    &quot;score&quot;: 1337,
    &quot;playerName&quot;: &quot;Sean Plott&quot;,
    &quot;cheatMode&quot;: false,
    &quot;skills&quot;: [
        &quot;pwnage&quot;,
        &quot;flying&quot;
    ],
    &quot;game&quot;: {
        &quot;type&quot;: &quot;Object&quot;,
        &quot;className&quot;: &quot;Game&quot;,
        &quot;name&quot;: &quot;愤怒的小鸡&quot;,
    }
    &quot;createdAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;updatedAt&quot;: &quot;2011-08-20 02:06:57&quot;,
    &quot;objectId&quot;: &quot;e1kXT22L&quot;
}
</code></pre>

<h3 id="_24">查询多条数据<a class="headerlink" href="#_24" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong>
为了一次获取多个对象，你可以通过发送一个GET请求到类的URL上，不需要任何URL参数。具体如下。</p>
<p><strong>请求</strong></p>
<ul>
<li>url ：https://api2.bmob.cn/1/classes/TableName</li>
<li>method ：GET</li>
<li>header:</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>status: 200 OK</li>
<li>body:</li>
</ul>
<pre><code>{
  &quot;results&quot;: [
    {
      key1:value1,
      key2:value2,
      ...
    },
    {
      key1:value1,
      key2:value2,
      ...
    },
    ...
</code></pre>

<p><strong>例子</strong></p>
<p>下面就是简单地获取所有在GameScore类之中的对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回的值就是一个JSON对象包含了results字段,它的值就是对象的列表:</p>
<pre><code>{
    &quot;results&quot;: [
    {
        &quot;playerName&quot;: &quot;Jang Min Chul&quot;,
        &quot;updatedAt&quot;: &quot;2011-08-19 02:24:17&quot;,
        &quot;cheatMode&quot;: false,
        &quot;createdAt&quot;: &quot;2011-08-19 02:24:17&quot;,
        &quot;objectId&quot;: &quot;51c3ba67e4b0f0e851c16221&quot;,
        &quot;score&quot;: 80075
    },
    {
        &quot;playerName&quot;: &quot;Sean Plott&quot;,
        &quot;updatedAt&quot;: &quot;2011-08-21 18:02:52&quot;,
        &quot;cheatMode&quot;: false,
        &quot;createdAt&quot;: &quot;2011-08-20 02:06:57&quot;,
        &quot;objectId&quot;: &quot;e1kXT22L&quot;,
        &quot;score&quot;: 73453
    }
    ]
}
</code></pre>

<p>怎么样，是不是很简单，而且查询的结果不需要任何处理，你直接使用即可。</p>
<h3 id="_25">条件查询<a class="headerlink" href="#_25" title="Permanent link">&para;</a></h3>
<p>条件查询就是在查询所有数据的请求上通过where参数的形式对查询对象做出约束，只返回我们功期望返回的值。</p>
<p>where参数的值应该是JSON编码过的，就是说，如果你查看真正被发出的URL请求，它应该是先被JSON编码过，然后又被URL编码过。</p>
<p>使用where参数最简单的方式就是包含应有的key的值。举例说,如果我们想要得到Lily的记录，那该请求的URL为：</p>
<pre><code>https://api2.bmob.cn/1/classes/GameScore?where={&quot;name&quot;:&quot;Lily&quot;}
</code></pre>

<p>这是未经编码前我们看到的url，我们需要对URL进行URL编码，编码的的结果为：</p>
<pre><code>https://api2.bmob.cn/1/classes/GameScore?where=%7B%22name%22:%22Lily%22%7D
</code></pre>

<p><strong>不同的语言开发环境有不同的URL编码接口，如果是使用如Postman这类工具来进行测试的，可以使用一些在线的url编解码工具进行编码后再发送请求，这里推荐一个<a href="http://web.chacuo.net/charseturlencode">http://web.chacuo.net/charseturlencode</a></strong></p>
<p>where的参数值除了上面的准确匹配外，还支持比较运算符的方式，除了给定一个确定值的方式，还可以提供一个hash中包含有key用于比较，where参数支持下面一些选项:</p>
<table>
<thead>
<tr>
<th align="center">Key</th>
<th align="center">Operation</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">$lt</td>
<td align="center">小于</td>
</tr>
<tr>
<td align="center">$lte</td>
<td align="center">小于等于</td>
</tr>
<tr>
<td align="center">$gt</td>
<td align="center">大于</td>
</tr>
<tr>
<td align="center">$gte</td>
<td align="center">大于等于</td>
</tr>
<tr>
<td align="center">$ne</td>
<td align="center">不等于</td>
</tr>
<tr>
<td align="center">$in</td>
<td align="center">包含在数组中</td>
</tr>
<tr>
<td align="center">$nin</td>
<td align="center">不包含在数组中</td>
</tr>
<tr>
<td align="center">$exists</td>
<td align="center">这个 Key 有值</td>
</tr>
<tr>
<td align="center">$select</td>
<td align="center">匹配另一个查询的返回值</td>
</tr>
<tr>
<td align="center">$dontSelect</td>
<td align="center">排除另一个查询的返回</td>
</tr>
<tr>
<td align="center">$all</td>
<td align="center">包括所有给定的值</td>
</tr>
<tr>
<td align="center">$regex</td>
<td align="center">匹配PCRE表达式</td>
</tr>
</tbody>
</table>
<p>作为示例，为了获取score得分在[1000,3000]之间的对象，我们需要这样做:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;score&quot;:{&quot;$gte&quot;:1000,&quot;$lte&quot;:3000}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>为了获得score得分在10以下并且是一个奇数，我们需要这样做:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;score&quot;:{&quot;$in&quot;:[1,3,5,7,9]}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>为了获得scoreArray得分包括数组中所有的值，如scoreArray是[1,3, 5, 7]就满足，是[1, 5,10]就不满足:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;scoreArray&quot;:{&quot;$all&quot;:[1,3,5]}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>为了获取playerName不在列表中的GameScore对象们，我们可以:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;playerName&quot;:{&quot;$nin&quot;:[&quot;Jonathan Walsh&quot;,&quot;Dario Wunsch&quot;,&quot;Shawn Simon&quot;]}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>为了获取有分数的对象，我们应该用:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;score&quot;:{&quot;$exists&quot;:true}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>为了获取没有分数的对象，用:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;score&quot;:{&quot;$exists&quot;:false}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>你还可以使用模糊查询，支持PCRE正则表达式：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;playerName&quot;:{&quot;$regex&quot;:&quot;smile.*&quot;}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p><strong>注:模糊查询只对付费用户开放，付费后可直接使用。</strong></p>
<p>如果您的查询条件某个列值要匹配另一个查询的返回值，举例有一个队伍(Team)保存了每个城市的得分情况且用户表中有一列为用户家乡(hometown), 您可以创建一个查询来寻找用户的家乡是得分大于0.5的城市的所有运动员， 就像这样查询:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;hometown&quot;:{&quot;$select&quot;:{&quot;query&quot;:{&quot;className&quot;:&quot;Team&quot;,&quot;where&quot;:{&quot;winPct&quot;:{&quot;$gt&quot;:0.5}}},&quot;key&quot;:&quot;city&quot;}}}' \
    https://api2.bmob.cn/1/users
</code></pre>

<p>反之查询Team中得分小于等于0.5的城市的所有运动员，构造查询如下：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;hometown&quot;:{&quot;$dontSelect&quot;:{&quot;query&quot;:{&quot;className&quot;:&quot;Team&quot;,&quot;where&quot;:{&quot;winPct&quot;:{&quot;$gt&quot;:0.5}}},&quot;key&quot;:&quot;city&quot;}}}' \
    https://api2.bmob.cn/1/users
</code></pre>

<h4 id="_26">分页查询<a class="headerlink" href="#_26" title="Permanent link">&para;</a></h4>
<p>你可以用limit和skip来做分页，limit的默认值是100，企业pro版套餐limit的最大值为1000，其它版套餐limit的最大值为500，就是说，为了获取在400到600之间的对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'limit=200' \
    --data-urlencode 'skip=400' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<h4 id="_27">排序<a class="headerlink" href="#_27" title="Permanent link">&para;</a></h4>
<p>你可以用order参数指定一个字段来排序，前面加一个负号的前缀表示降序，这样返回的对象会以score升序排列:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'order=score' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>而以下这样返回的对象会以score降序排列:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'order=-score' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>你可以用多个字段进行排序，只要用一个逗号隔开列表就可以，为了获取GameScore，以score的升序和name的降序进行排序:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'order=score,-name' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<h3 id="_28">复合查询<a class="headerlink" href="#_28" title="Permanent link">&para;</a></h3>
<table>
<thead>
<tr>
<th align="center">Key</th>
<th align="center">Operation</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">$or</td>
<td align="center">复合查询中的或查询</td>
</tr>
<tr>
<td align="center">$and</td>
<td align="center">复合查询中的与查询</td>
</tr>
</tbody>
</table>
<p>如果你想查询对象符合几种查询之一，你可以使用$or或$and操作符，带一个JSON数组作为它的值。例如，如果你想找到player赢了很多或者赢了很少，你可以用如下的方式:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;$or&quot;:[{&quot;wins&quot;:{&quot;$gt&quot;:150}},{&quot;wins&quot;:{&quot;$lt&quot;:5}}]}' \
    https://api2.bmob.cn/1/classes/Player
</code></pre>

<p>查询今天内的数据，方式如下:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;$and&quot;:[{&quot;createdAt&quot;:{&quot;$gte&quot;:{&quot;__type&quot;: &quot;Date&quot;, &quot;iso&quot;: &quot;2014-07-15 00:00:00&quot;}}},\
    {&quot;createdAt&quot;:{&quot;$lte&quot;:{&quot;__type&quot;: &quot;Date&quot;, &quot;iso&quot;: &quot;2014-07-15 23:59:59&quot;}}}]}' \
    https://api2.bmob.cn/1/classes/Player
</code></pre>

<p><strong>因为createdAt updatedAt服务器自动生成的时间，在服务器保存的是精确到微秒值的时间，所以基于时间类型比较的值要加1秒。</strong></p>
<p>任何在查询上的其他的约束都会对返回的对象生效，所以你可以用$or对其他的查询添加约束。</p>
<p>注意我们不会在 <strong>组合查询的子查询</strong> 中支持非过滤型的约束(例如:limit skip sort include)，但最外层的查询中是支持非过滤型约束的。</p>
<h3 id="_29">查询结果计数<a class="headerlink" href="#_29" title="Permanent link">&para;</a></h3>
<p>如果你在使用limit，或者如果返回的结果很多，你可能想要知道到底有多少对象应该返回，而不用把它们全部获得以后再计数，此时你可以使用count参数。举个例子，如果你仅仅是关心一个特定的玩家玩过的游戏数量：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;playerName&quot;:&quot;Jonathan Walsh&quot;}' \
    --data-urlencode 'count=1' \
    --data-urlencode 'limit=0' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>因为请求了count而且把limit设为了0，返回的值里面只有计数，results为空数组集。</p>
<pre><code>{
    &quot;results&quot;: [

    ],
    &quot;count&quot;: 1337
}
</code></pre>

<p>如果有一个非0的limit的话，既会返回正确的results也会返回count的值。</p>
<h3 id="_30">查询指定列<a class="headerlink" href="#_30" title="Permanent link">&para;</a></h3>
<p>你可以限定返回的字段，通过传入keys参数，值为用一个逗号分隔的字段名称列表，为了获取对象只包含score和playerName字段(还有特殊的内置字段比如objectId,createdAt和updatedAt)，请求如下：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'keys=score,playerName' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<h3 id="_31">统计相关的查询<a class="headerlink" href="#_31" title="Permanent link">&para;</a></h3>
<p>Bmob的统计查询，提供以下关键字或其组合的查询操作：</p>
<table>
<thead>
<tr>
<th align="center">Key</th>
<th align="center">Operation</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">groupby</td>
<td align="center">分组操作</td>
</tr>
<tr>
<td align="center">groupcount</td>
<td align="center">返回每个分组的总记录</td>
</tr>
<tr>
<td align="center">sum</td>
<td align="center">计算总和</td>
</tr>
<tr>
<td align="center">average</td>
<td align="center">计算平均值</td>
</tr>
<tr>
<td align="center">max</td>
<td align="center">计算最大值</td>
</tr>
<tr>
<td align="center">min</td>
<td align="center">计算最小值</td>
</tr>
<tr>
<td align="center">having</td>
<td align="center">分组中的过滤条件</td>
</tr>
</tbody>
</table>
<p>为避免和用户创建的列名称冲突，Bmob约定以上统计关键字（sum, max, min)的查询结果值都用 <code>_(关键字)+首字母大写的列名</code> 的格式，如计算玩家得分列名称为score总和的操作，则返回的结果集会有一个列名为_sumScore。average返回的列为 <code>_avg+首字母大写的列名</code> ，有groupcount的情形下则返回_count。</p>
<p>以上关键字除了groupcount是传Boolean值true或false，having传的是和where类似的json字符串，但having只应该用于过滤分组查询得到的结果集，即having只应该包含结果集中的列名如 <code>{"_sumScore":{"$gt":100}}</code> ，其他关键字必须是字符串而必须是表中包含的列名，多个列名用,分隔。</p>
<p>比如，GameScore表是游戏玩家的信息和得分表，有playerName(玩家名称)、score(玩家得分)等你自己创建的列，还有Bmob的默认列objectId, createdAt, updatedAt,那么我们现在举例如何使用以上的查询关键字来作这个表的统计。</p>
<h4 id="_32">计算总和<a class="headerlink" href="#_32" title="Permanent link">&para;</a></h4>
<p>我们要计算GameScore表所有玩家的得分总和，sum后面只能拼接Number类型的列名，即要计算哪个列的值的总和，只对Number类型有效，多个Number列用,分隔，则查询如下：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'sum=score' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;_sumScore&quot;: 2398
    }
]

</code></pre>

<h4 id="_33">分组计算总和<a class="headerlink" href="#_33" title="Permanent link">&para;</a></h4>
<p>比如我们以创建时间按天统计所有玩家的得分，并按时间降序, groupby后面只能拼接列名，如果该列是时间类型，则按天分组，其他类型，则按确定值分组:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'sum=score&amp;groupby=createdAt&amp;order=-createdAt' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;_sumScore&quot;: 2398,
        &quot;createdAt&quot;: &quot;2014-02-05&quot;
    },
    {
        &quot;_sumScore&quot;: 1208,
        &quot;createdAt&quot;: &quot;2014-01-01&quot;
    },
]
</code></pre>

<h4 id="_34">多个分组并计算多个列的总和<a class="headerlink" href="#_34" title="Permanent link">&para;</a></h4>
<p>比如我们以创建时间按天和按玩家名称分组统计所有玩家的得分1，得分2的总和，并按得分1的总和降序, groupby后面只能拼接列名，如果该列是时间类型，则按天分组，其他类型，则按确定值分组:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'sum=score1,score2&amp;groupby=createdAt,playerName&amp;order=-_sumscore1' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;_sumScore1&quot;: 399,
        &quot;_sumScore2&quot;: 120,
        &quot;playerName&quot;: &quot;John&quot;
        &quot;createdAt&quot;: &quot;2014-02-05&quot;
    },
    {
        &quot;_sumScore1&quot;: 299,
        &quot;_sumScore2&quot;: 250,
        &quot;playerName&quot;: &quot;Bily&quot;
        &quot;createdAt&quot;: &quot;2014-02-05&quot;
    },
    {
        &quot;_sumScore1&quot;: 99,
        &quot;_sumScore2&quot;: 450,
        &quot;playerName&quot;: &quot;John&quot;
        &quot;createdAt&quot;: &quot;2014-02-01&quot;
    },
]
</code></pre>

<h4 id="_35">分组计算总和并只返回满足条件的部分值<a class="headerlink" href="#_35" title="Permanent link">&para;</a></h4>
<p>比如我们以创建时间按天统计所有玩家的得分，并只返回某天的总得分大于2000的记录，并按时间降序，having是用于过滤部分结果，其中的_sumScore是 <code>_sum+首字母大写的列名</code> 的格式表示是计算这个列的总和的值:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'sum=score&amp;having={&quot;_sumScore&quot;:{&quot;$gt&quot;: 2000}}&amp;groupby=createdAt&amp;order=-createdAt' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;_sumScore&quot;: 2398,
        &quot;createdAt&quot;: &quot;2014-02-05&quot;
    },
]
</code></pre>

<h4 id="_36">分组计算总和并返回每个分组的记录数<a class="headerlink" href="#_36" title="Permanent link">&para;</a></h4>
<p>比如我们以创建时间按天统计所有玩家的得分和每一天有多少条玩家的得分记录，并按时间降序:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'sum=score&amp;groupby=createdAt&amp;groupcount=true&amp;order=-createdAt' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;_sumScore&quot;: 2398,
        &quot;_count&quot;: 10,
        &quot;createdAt&quot;: &quot;2014-02-05&quot;
    },
    {
        &quot;_sumScore&quot;: 100,
        &quot;_count&quot;: 2,
        &quot;createdAt&quot;: &quot;2014-01-01&quot;
    },
]
</code></pre>

<h4 id="_37">获取不重复的列值<a class="headerlink" href="#_37" title="Permanent link">&para;</a></h4>
<p>比如我们获取表中所有的唯一的score:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'groupby=score' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<p>返回内容如下：</p>
<pre><code>[
    {
        &quot;score&quot;: 78
    },
    {
        &quot;score&quot;: 89
    }
]
</code></pre>

<h4 id="_38">其他关键字<a class="headerlink" href="#_38" title="Permanent link">&para;</a></h4>
<p>average(计算平均值)， max(计算最大值)，min(计算最小值)和sum查询语句是类似的，只用把上面的例子中的sum替换为相应的average, max, min就可以了。</p>
<h3 id="bql">BQL查询<a class="headerlink" href="#bql" title="Permanent link">&para;</a></h3>
<p>我们还提供类 SQL 语法的 BQL 查询语言来查询数据，例如：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'bql=select * from Player limit 0,100 order by name' \
  https://api2.bmob.cn/1/cloudQuery
</code></pre>

<p>更多请参考 <a href="../../../other/Other/m_bql/doc/index.html" title="BQL 详细指南">BQL 详细指南</a> 。</p>
<p>BQL 还支持占位符查询，where 和 limit 子句的条件参数可以使用问号替换，然后通过 <code>values</code> 数组传入：</p>
<pre><code>curl -X GET \
   -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
   -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'bql=select * from Player where name=? limit ?,? order by name' \
  --data-urlencode 'values=[&quot;dennis&quot;, 0, 100]'
  https://api2.bmob.cn/1/cloudQuery
</code></pre>

<h2 id="_39">数组<a class="headerlink" href="#_39" title="Permanent link">&para;</a></h2>
<p>为了存储数组型数据，<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>提供了3种操作来原子性地更改一个数组字段:</p>
<p><strong>Add</strong> 在一个数组字段的后面添加一些指定的对象(包装在一个数组内)</p>
<p><strong>AddUnique</strong> 只会在原本数组字段中没有这些对象的情形下才会添加入数组，插入数组的位置不固定的</p>
<p><strong>Remove</strong> 从一个数组字段的值内移除指定的数组中的所有对象</p>
<h3 id="_40">添加数组数据<a class="headerlink" href="#_40" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>添加数据时添加一个数据字段。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1:{&quot;__op&quot;:&quot;Add&quot;,&quot;objects&quot;:[value1,value2...]},

  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>{
  "createdAt": "YYYY-mm-dd HH:ii:ss",
  "objectId": objectId
}</p>
<p><strong>例子</strong></p>
<p>给GameScore添加一条记录其中一个字体为数组，包含一些技能，可进行如下请求:</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;skill&quot;:{&quot;__op&quot;:&quot;Add&quot;,&quot;objects&quot;:[&quot;skill1&quot;,&quot;skill2&quot;]}}' \
    https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<h3 id="_41">更新数组数据<a class="headerlink" href="#_41" title="Permanent link">&para;</a></h3>
<h4 id="_42">普通更新<a class="headerlink" href="#_42" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>数组对象生成后，还可以对其进行更新，往数组里面添加内容。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
   key1:{&quot;__op&quot;:&quot;AddUnique&quot;,&quot;objects&quot;:[value1,value2...]},
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;updatedAt&quot;: &quot;YYYY-mm-dd HH:ii:ss&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>如在GameScore的e1kXT22L再添加两个技能，并且只有在这两个技能不存在时才加入，则可以使用以下请求：</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;skills&quot;:{&quot;__op&quot;:&quot;AddUnique&quot;,&quot;objects&quot;:[&quot;flying&quot;,&quot;kungfu&quot;]}}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h4 id="key">使用索引和对象key修改数组中的对象<a class="headerlink" href="#key" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>当数组中存储的是JSON对象时，可以使用该请求单独修改JSON对象中的某个值。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1.number.keyOfJson : value1,
  key2.number.keyOfJson : value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;updatedAt&quot;: &quot;YYYY-mm-dd HH:ii:ss&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>比如你当前行有一列叫用户的工作经验projectExperiences，是一个Array数组列，里面包含了多个对象值：[{"name":"项目名称","descr":"项目描述"，"startTime":"开始时间"，"endTime":"结束时间"}, ...]</p>
<p>那么我们要修改projectExperiences数组中第一个对象的name值：</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;projectExperiences.0.name&quot;:&quot;项目名称2&quot;}' \
    https://api2.bmob.cn/1/users/e1kXT22L
</code></pre>

<h3 id="_43">删除数组数据<a class="headerlink" href="#_43" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
   key1:{&quot;__op&quot;:&quot;Remove&quot;,&quot;objects&quot;:[value1,value2...]},
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;updatedAt&quot;: &quot;YYYY-mm-dd HH:ii:ss&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>把GameScore里objectId为e1kXT22L对象的技能移除。</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;skills&quot;:{&quot;__op&quot;:&quot;Remove&quot;,&quot;objects&quot;:[&quot;flying&quot;,&quot;kungfu&quot;]}}' \
    https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_44">查询数组数据<a class="headerlink" href="#_44" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/classes/TableName</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>params:</p>
</li>
</ul>
<pre><code>//查找数组中含有特定值
where={arraykey1:value1,arraykey2:value2,...}

or

//查找数据组同时含有若干个值
where={&quot;arrayKey&quot;:{&quot;$all&quot;:[value1,value2,...]}}
</code></pre>

<ul>
<li>header:</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;results&quot;: [
    {
      key1:value1,
      key2:value2,
      ...
    },
    {
      key1:value1,
      key2:value2,
      ...
    },
    ...
</code></pre>

<p><strong>例子</strong></p>
<p>例如，可以查找Key的数组值中包含有2的对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;arrayKey&quot;:2}' \
    https://api2.bmob.cn/1/classes/RandomObject
</code></pre>

<p>还同样可以使用"$all"操作符来找到类型为数组的Key的值中包含有2,3和4的对象:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={&quot;arrayKey&quot;:{&quot;$all&quot;:[2,3,4]}}' \
    https://api2.bmob.cn/1/classes/RandomObject
</code></pre>

<h2 id="_45">数据关联<a class="headerlink" href="#_45" title="Permanent link">&para;</a></h2>
<h3 id="_46">关联对象<a class="headerlink" href="#_46" title="Permanent link">&para;</a></h3>
<p>在程序设计中，不同类型的数据之间可能存在某种关系。分别是以下三种：
1. 一对一，比如车队给司机分车，1个司机对应1台车；
2. 一对多，比如1个作者会对应多篇贴子；
3. 多对多，比如1篇帖子会有多个喜欢的读者，而每个读者也会有多篇喜欢的帖子。
前面的两种关系我们提供Pointer类型来表示，而最后一种关系我们使用Relation类型来表示</p>
<p>在下面的讲解中我们可能会使用到以下的两张表，其表结构如下：</p>
<p>_User</p>
<table>
<thead>
<tr>
<th align="left">字段</th>
<th align="left">类型</th>
<th align="left">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">objectId</td>
<td align="left">string</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">username</td>
<td align="left">string</td>
<td align="left">用户名，用户可以是作者发帖子，也可以是读者发评论</td>
</tr>
</tbody>
</table>
<p>Post</p>
<table>
<thead>
<tr>
<th align="left">字段</th>
<th align="left">类型</th>
<th align="left">含义</th>
</tr>
</thead>
<tbody>
<tr>
<td align="left">objectId</td>
<td align="left">string</td>
<td align="left"></td>
</tr>
<tr>
<td align="left">title</td>
<td align="left">string</td>
<td align="left">帖子标题</td>
</tr>
<tr>
<td align="left">content</td>
<td align="left">string</td>
<td align="left">帖子内容</td>
</tr>
<tr>
<td align="left">author</td>
<td align="left">Pointer(_User)</td>
<td align="left">作者</td>
</tr>
<tr>
<td align="left">likes</td>
<td align="left">Relation(_User)</td>
<td align="left">喜欢帖子的读者</td>
</tr>
</tbody>
</table>
<h3 id="pointer">Pointer的使用<a class="headerlink" href="#pointer" title="Permanent link">&para;</a></h3>
<p>Pointer可用于表示一对一及一对多的关系。</p>
<p>Pointer本质类似于指针，使用 <code>className</code> 和 <code>objectId</code> 来定位具体的对象。具体的操作如下。</p>
<h4 id="pointer_1">添加Pointer<a class="headerlink" href="#pointer_1" title="Permanent link">&para;</a></h4>
<p>添加Pointer其实与普通的添加对象是一样的，使用的请求也是添加对象的接口，只是其中的 key-value对中的value的格式为</p>
<pre><code>{
    &quot;__type&quot;:&quot;Pointer&quot;,
    &quot;className&quot;:tableName,
    &quot;objectId&quot;:objectId
}
</code></pre>

<p>例如，如果我们需要添加一篇帖子，并关联至其作者，可以采用以下请求：</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{ \
            &quot;title&quot;: &quot;how to user pointer&quot;, \           &quot;user&quot; : { \
            &quot;__type&quot;:&quot;Pointer&quot;, \
            &quot;className&quot;:&quot;_User&quot;, \
            &quot;objectId&quot;:&quot;DdUOIIIW&quot; \
            } \
         }' \
  https://api2.bmob.cn/1/classes/GameScore
</code></pre>

<h4 id="pointer_2">删除Pointer<a class="headerlink" href="#pointer_2" title="Permanent link">&para;</a></h4>
<p>与删除普通列值一样，例如要删除帖子(Post)的作者，如下</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;author&quot;:{&quot;__op&quot;:&quot;Delete&quot;}}' \
    https://api2.bmob.cn/1/classes/Post/e1kXT22L
</code></pre>

<h4 id="pointer_3">修改Pointer<a class="headerlink" href="#pointer_3" title="Permanent link">&para;</a></h4>
<p>与修改普通列值一样，只是新的值需要满足Pointer的格式，如下</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{ \
                &quot;title&quot;: &quot;how to user pointer&quot;, \               &quot;user&quot; : { \
                &quot;__type&quot;:&quot;Pointer&quot;, \
                &quot;className&quot;:&quot;_User&quot;, \
                &quot;objectId&quot;:&quot;objectId&quot; \ (新关联作者的objectId)
                } \
         }'
    https://api2.bmob.cn/1/classes/Post/e1kXT22L
</code></pre>

<h4 id="pointer_4">查询Pointer<a class="headerlink" href="#pointer_4" title="Permanent link">&para;</a></h4>
<p>在某些情况之下，你可能需要在一个查询之中返回关联对象的所有值，你可以通过传入字段名称到include参数中，多个字段名称用,间隔。比如，在查询Post时还想将其相关联的user对象取出来，如下</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'include=author' \
  https://api2.bmob.cn/1/classes/Post
</code></pre>

<p>返回的user字段的值如下：</p>
<pre><code>{
  &quot;__type&quot;: &quot;Object&quot;,
  &quot;className&quot;: &quot;_User&quot;,
  &quot;objectId&quot;: &quot;51e3a359e4b015ead4d95ddc&quot;,
  &quot;createdAt&quot;: &quot;2011-12-06T20:59:34.428Z&quot;,
  &quot;updatedAt&quot;: &quot;2011-12-06T20:59:34.428Z&quot;,
  &quot;otherFields&quot;: &quot;willAlsoBeIncluded&quot;
}
</code></pre>

<p>而没有使用include时，返回的user字段值则是如下形式：</p>
<pre><code>{
  &quot;__type&quot;: &quot;Pointer&quot;,
  &quot;className&quot;: &quot;_User&quot;,
  &quot;objectId&quot;: &quot;51e3a359e4b015ead4d95ddc&quot;
}
</code></pre>

<p>你可以同样做多层的include, 这时要使用 "." 号. 如果你要include一条评论(Comment)对应的帖子(Post)的作者(author)：</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'order=-createdAt' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'include=post.author' \
  https://api2.bmob.cn/1/classes/Comment
</code></pre>

<p>如果你要构建一个查询, 这个查询要include多个 <strong>Pointer</strong> 类型的Key, 此时用逗号分隔Key名称列表即可。</p>
<p>另外，include 还可以只返回指定的keys，即 Pointer 类型的字段指向的表只返回指定的字段，举例如下：</p>
<p><strong>建议大家使用以下方式，只返回需要的值，性能更好，流量更少</strong></p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'include=post[likes].author[username|email],user[username]' \
  https://api2.bmob.cn/1/classes/Comment
</code></pre>

<p>post 指向的帖子表只返回likes字段，而author指向的用户表只返回username和email字段，user指向的用户表只返回username字段。</p>
<h4 id="pointer_5">约束Pointer值查询<a class="headerlink" href="#pointer_5" title="Permanent link">&para;</a></h4>
<p>在查询当中，我们可以对字符串、数组、数字等进行约束，比如查询Post表时，我们可以指定只返回title以“a”开头的Post对象。那么Pointer能不能也进行约束呢？如下：</p>
<p>1.如果约束的是某个特定对象，即知道该对象的objectId，您可以用一个 <code>where</code> 参数查询, 自己使用 <code>__type</code> 构造一个 <code>Pointer</code>, 就像你构造其他数据类型一样。举例说, 如果每一条评论(Comment对象)有一个Key叫post，类型是Pointer，并且指向了一个具体的帖子(Post对象，用objectId表示一个帖子)，那么您可以使用下面的请求获取一个帖子的所有评论</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'where={&quot;post&quot;:{&quot;__type&quot;:&quot;Pointer&quot;,&quot;className&quot;:&quot;Post&quot;,&quot;objectId&quot;:&quot;1dafb9ed9b&quot;}}' \
  https://api2.bmob.cn/1/classes/Comment
</code></pre>

<p>2.如果想要约束关联对象除objectId外的其它值，比如我想要返回所有指向的author指向的对象，其username都为Lily的Post对象，该如何做呢？我们可以使用 "$inQuery" 来完成，具体如下：</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'where= { \
                                &quot;author&quot;: { \
                                    &quot;$inQuery&quot;: { \
                                    &quot;where&quot;: { \
                                          &quot;username&quot;: &quot;Lily&quot; \
                                    }, \
                                    &quot;className&quot;: &quot;_User&quot; \
                                } \
                                 } \
                            }' \
  https://api2.bmob.cn/1/classes/Post
</code></pre>

<p>如果需求是不匹配查询条件的，比较要找username不是Lily的Post对象，只需要将 <code>$inQuery</code> 替换成 <code>$notInQuery</code> 即可。</p>
<h3 id="relation">Relation的使用<a class="headerlink" href="#relation" title="Permanent link">&para;</a></h3>
<p>Relation可用于表示多对多的关系。其本质是一个Pointer的数组。具体的操作介绍如下。</p>
<h4 id="relation_1">添加Relation<a class="headerlink" href="#relation_1" title="Permanent link">&para;</a></h4>
<p>添加 <code>Relation</code> 返回使用的也是添加对象的接口，对应的 <code>key-value</code> 对中的 <code>value</code> 需要满足以下格式</p>
<pre><code>{
  key: {
    &quot;__op&quot;: &quot;AddRelation&quot;,
    &quot;objects&quot;: [
      {
        &quot;__type&quot;: &quot;Pointer&quot;,
        &quot;className&quot;: className,
        &quot;objectId&quot;: objectId
      },
      {
        &quot;__type&quot;: &quot;Pointer&quot;,
        &quot;className&quot;: className,
        &quot;objectId&quot;: objectId
      }
    ]
  }
}
</code></pre>

<p>如需要给一个 <code>Post</code> 对象添加两个喜欢该 <code>Post</code> 的读者，可以使用以下方法。</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{ &quot;likes&quot;: { \
          &quot;__op&quot;: &quot;AddRelation&quot;, \
          &quot;objects&quot;: [ \
            { \
             &quot;__type&quot;: &quot;Pointer&quot;, \
             &quot;className&quot;: &quot;_User&quot;, \
             &quot;objectId&quot;: &quot;z0lOxp1X&quot; \
            }, \
            { \
             &quot;__type&quot;: &quot;Pointer&quot;, \
             &quot;className&quot;: &quot;_User&quot;, \
             &quot;objectId&quot;: &quot;MTzXDDDG&quot; \
            } \
           ] \
        } \
      }' \
  https://api2.bmob.cn/1/classes/Post/z0lOxp12
</code></pre>

<h4 id="relation_2">删除Relation<a class="headerlink" href="#relation_2" title="Permanent link">&para;</a></h4>
<p>与普通的更新对象接口一样，只是需要使用特定的格式，具体如下：</p>
<pre><code>{
  key: {
    &quot;__op&quot;: &quot;RemoveRelation&quot;,
    &quot;objects&quot;: [
      {
        &quot;__type&quot;: &quot;Pointer&quot;,
        &quot;className&quot;: className,
        &quot;objectId&quot;: objectId
      },
      {
        &quot;__type&quot;: &quot;Pointer&quot;,
        &quot;className&quot;: className,
        &quot;objectId&quot;: objectId
      }
    ]
  }
}
</code></pre>

<p>如有读者取消了对某篇帖子的收藏，可以进行如下操作:</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{ &quot;likes&quot;: { \
          &quot;__op&quot;: &quot;RemoveRelation&quot;, \
          &quot;objects&quot;: [ \
            { \
             &quot;__type&quot;: &quot;Pointer&quot;, \
             &quot;className&quot;: &quot;_User&quot;, \
             &quot;objectId&quot;: &quot;z0lOxp1X&quot; \
            }
      }' \
  https://api2.bmob.cn/1/classes/Post/z0lOxp2a
</code></pre>

<h4 id="relation_3">查询Relation<a class="headerlink" href="#relation_3" title="Permanent link">&para;</a></h4>
<p>如果我们需要查询喜欢某篇帖子的所有作者，那么可以使用 <code>$relatedTo</code>，可以使用以下请求，与Pointer不同的是，此处我们直接查询的是_User表，<code>$relatedTo</code> 跟的是帖子的具体记录。</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'where={&quot;$relatedTo&quot;:{&quot;object&quot;:{&quot;__type&quot;:&quot;Pointer&quot;,&quot;className&quot;:&quot;Post&quot;,&quot;objectId&quot;:&quot;1dafb9ed9b&quot;},&quot;key&quot;:&quot;likes&quot;}}' \
  https://api2.bmob.cn/1/users
</code></pre>

<h4 id="relation_4">约束Relation进行查询<a class="headerlink" href="#relation_4" title="Permanent link">&para;</a></h4>
<p>跟Pointer一样，我们同样可以使用 <code>$inQuery</code> 和 <code>$notInQuery</code> 对Relation的指向的对象的某些属性进行约束。例如，如果需要找到 <code>Lily</code> 喜欢的所有帖子，可以使用以下请求：</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -G \
  --data-urlencode 'where= { \
                                &quot;likes&quot;: { \
                                    &quot;$inQuery&quot;: { \
                                    &quot;where&quot;: { \
                                          &quot;username&quot;: &quot;Lily&quot; \
                                    }, \
                                    &quot;className&quot;: &quot;_User&quot; \
                                } \
                                 } \
                            }' \
  https://api2.bmob.cn/1/classes/Post
</code></pre>

<h2 id="_47">用户管理<a class="headerlink" href="#_47" title="Permanent link">&para;</a></h2>
<p>很多跨平台和跨系统的应用都有一个统一的登录流程，<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>通过REST API访问用户的账户让你实现该功能。</p>
<p>通常来说，用户这个类的功能与其他的对象是相同的，比如都没有限制模式(Schema Less)，User对象和其他对象不同的是一个用户必须有用户名(username)和密码(password)，密码会被自动地加密和存储。<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>强制你username和email这两个Key的值必须是不重复的。</p>
<h3 id="_48">属性<a class="headerlink" href="#_48" title="Permanent link">&para;</a></h3>
<p><a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>默认会有几个特定的属性：
username: 用户的用户名<code>（必需）</code>。
password: 用户的密码<code>（必需）</code>。
email: 用户的电子邮件地址<code>（可选）</code>。</p>
<h3 id="_49">注册用户<a class="headerlink" href="#_49" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>注册一个新用户与创建一个新的普通对象之间的不同点在于其username和password字段都是必要的，password字段会以与其他的字段不一样的方式处理，它在保存时会被加密而且永远不会被返回给任何来自客户端的请求。</p>
<p>在你的应用设置页面中，你可以向<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>来请求认证邮件地址，这项设置启用了的话，所有用户在注册时填写email这个Key的值，并且邮箱有效的情况下，就会向这个邮箱地址发出一封邮件，邮件中会包含一个来自<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>的邮箱验证的链接，当你的用户查收邮件并点击这个链接后，这个用户emailVerified的Key的值会置为True，你可以在emailVerified字段上查看用户的email是否已经通过验证了。</p>
<p>为了注册一个新的用户，需要向user路径发送一个POST请求，你可以加入一个甚至多个新的字段。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/users</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;username&quot; : username,
  &quot;password&quot; : password,
  key1:value1,
  key2:value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 201 Created</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>返回的主体是一个JSON对象，包含objectId，表示唯一的用户, createdAt时间戳表示用户注册时间, sessionToken可以被用来认证更新或删除这名用户信息的请求。</p>
<pre><code>{
    &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
    &quot;objectId&quot;: objectId,
    &quot;sessionToken&quot;: sessionToken
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，创建一个有家庭电话字段的新用户:</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;username&quot;:&quot;cooldude6&quot;,&quot;password&quot;:&quot;b_m7!-o8&quot;,&quot;phone&quot;:&quot;415-392-0202&quot;}' \
    https://api2.bmob.cn/1/users
</code></pre>

<p>其返回值如下：</p>
<pre><code>{
    &quot;createdAt&quot;: &quot;2011-11-07 20:58:34&quot;,
    &quot;objectId&quot;: &quot;Kc3M222J&quot;,
    &quot;sessionToken&quot;: &quot;pnktnjyb996sj4p156gjtp4im&quot;
}
</code></pre>

<p><strong>这里需要注意一点的是，有些时候你可能需要在用户注册时发送一封验证邮件，以确认用户邮箱的真实性。这时，你只需要登录自己的应用管理后台，在设置-&gt;邮件设置（下图）中把“邮箱验证”功能打开，Bmob云后端就会在注册时自动发动一封验证邮件给用户。</strong></p>
<p><img alt="" src="../image/email_verify.png" /></p>
<h3 id="_50">使用手机号码一键注册或登陆<a class="headerlink" href="#_50" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a> 支持让用户直接输入手机号码进行注册，如果手机号码存在则自动登陆。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/users</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  mobilePhoneNumber:phoneNumber,
  smsCode:smsCode
  key1 : value1,
  key2 : value2,
  ...
}
</code></pre>

<p>其中 <strong>mobilePhoneNumber</strong> 就是手机号码，而 <strong>smsCode</strong> 是使用 <a href="../../../Restful/developdoc/index.html?menukey=develop_doc&amp;key=develop_restful#请求短信验证码" title="请求短信验证码API">请求短信验证码API</a>发送到用户手机上的 6位验证码字符串。如果是新用户且不传入 username，默认用户名将是手机号码。</p>
<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;username&quot;: username,
  &quot;mobilePhoneNumber&quot;: mobilePhoneNumber,
  &quot;mobilePhoneVerified&quot;: boolValue,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToekn,
  key1:value1,
  key2:value2,
  ...
}
</code></pre>

<p>如果是第一次注册，将默认设置_User表的 <strong>mobilePhoneVerified</strong> 属性为 true。</p>
<p><strong>例子</strong></p>
<p>创建一个用户如下：</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;mobilePhoneNumber&quot;:&quot;185xxxxxxxx&quot;,&quot;smsCode&quot;:&quot;6位短信验证码&quot;}' \
    https://api2.bmob.cn/1/users
</code></pre>

<p>返回值</p>
<pre><code>{
  &quot;username&quot;: &quot;185xxxxxxxx&quot;,
  &quot;mobilePhoneNumber&quot;: &quot;185xxxxxxxx&quot;,
  &quot;mobilePhoneVerified&quot;: true,
  &quot;createdAt&quot;: &quot;2011-11-07 20:58:34&quot;,
  &quot;updatedAt&quot;: &quot;2011-11-07 20:58:34&quot;,
  &quot;objectId&quot;: &quot;Kc3M222J&quot;,
  &quot;sessionToken&quot;: &quot;pnktnjyb996sj4p156gjtp4im&quot;
}
</code></pre>

<h3 id="_51">登录用户<a class="headerlink" href="#_51" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>你的用户注册之后，你需要让他们用自己的用户名和密码登录，为了做到这一点，发送一个HTTP GET请求到 <strong>/1/login</strong> ，加上username和password作为URL编码后的参数。</p>
<p>另外，username 支持传入_User表的username或email或mobilePhoneNumber字段的值，作为登录的扩展功能，以实现邮箱和密码、手机号和密码登录功能。</p>
<p>除了有用户名或邮箱或手机号码和密码登录的功能，<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a> 还支持使用手机号码和验证码一键快速登录的功能，而 <strong>smsCode</strong> 是使用 <a href="http://docs.bmob.cn/sms/Restful/b_developdoc/doc/index.html" title="请求短信验证码API">请求短信验证码API</a>发送到用户手机上的 6位验证码字符串：</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/login</p>
</li>
<li>
<p>params:</p>
</li>
</ul>
<pre><code>用户名密码登陆
&quot;username&quot;=username(也可以使用email或者mobilePhoneNumber)
&quot;password&quot;=password

手机号验证码
&quot;mobilePhoneNumber&quot;=phoneNumber
&quot;smsCode&quot;:smsCode
</code></pre>

<ul>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;username&quot;: username,
  &quot;mobilePhoneNumber&quot;: mobilePhoneNumber,
  &quot;mobilePhoneVerified&quot;: boolValue,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToekn,
  key1:value1,
  key2:value2,
  ...
}
</code></pre>

<p><strong>例子</strong></p>
<p>使用用户名加密码登陆</p>
<pre><code>curl -X GET
    \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'username=cooldude6' \
    --data-urlencode 'password=b_m7!-o8' \
    https://api2.bmob.cn/1/login
</code></pre>

<p>使用手机号加验证码登陆</p>
<pre><code>curl -X GET
    \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'mobilePhoneNumber=185xxxxxxxx' \
    --data-urlencode 'smsCode=6位短信验证码' \
    https://api2.bmob.cn/1/login
</code></pre>

<h3 id="_52">获取当前用户<a class="headerlink" href="#_52" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>当注册一个用户后，你可以通过发送一个HTTP GET请求到用户注册成功时返回的HTTP请求头中的Location的URL获取用户的信息。比如，为了获取上面注册成功的用户</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/users/objectID</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    &quot;username&quot;: username,
    &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
    &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
    &quot;objectId&quot;: objectId
}
</code></pre>

<p><strong>例子</strong></p>
<p>获取objectId为Kc3M222J的用户可以使用以下请求。</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    https://api2.bmob.cn/1/users/Kc3M222J
</code></pre>

<h3 id="_53">检查用户的登录是否过期<a class="headerlink" href="#_53" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>当用户登录后，系统会返回用户一个session token，用这个api可以检查这个session token是否过期</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/checkSession/objectID</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
X-Bmob-Session-Token: Your Session Token
Content-Type: application/json
</code></pre>

<p><strong>不过期时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>过期时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    &quot;msg&quot;: &quot;fail&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>检查用户objectId为Kc3M222J的session token是否过期:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;X-Bmob-Session-Token: Your Session Token&quot; \
    https://api2.bmob.cn/1/checkSession/Kc3M222J
</code></pre>

<h3 id="_54">更新用户<a class="headerlink" href="#_54" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>在通常的情况下，我们都不希望用户去修改自己的数据，但可以通过认证让用户去做这件事，用户必须加入一个 <strong>X-Bmob-Session-Token</strong> 头部来请求这个更新操作，这个sessionToken在注册和登录时都会返回。该值的有效期为1年。</p>
<p>为了改动一个用户已经有的数据，需要对这个用户的URL发送一个HTTP PUT请求，任何你没有指定的key会保持不变，所以你可以只改动用户信息中的一部分，username和password可以更改，但是新的username不能重复。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/users/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
X-Bmob-Session-Token: sessionToken
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  key1 : value1,
  key2 : value2,
  ...
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
    &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss
}
</code></pre>

<p><strong>例子</strong></p>
<p>比如，如果我们想对 cooldude6 的电话做出一些改动，可以采用如下请求，</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;phone&quot;:&quot;415-369-6201&quot;}' \
    https://api2.bmob.cn/1/users/Kc3M222J
</code></pre>

<p><strong>在更新用户信息时，如果用户邮箱有变更并且在管理后台打开了邮箱验证选项的话，Bmob云后端同样会自动发动一封验证邮件给用户。</strong></p>
<h3 id="_55">删除用户<a class="headerlink" href="#_55" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong>
为了在<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>上删除一个用户，可以向用户的URL上发送一个DELETE请求，前提是你必须提供一个X-Bmob-Session-Token在Http请求头以便认证授权。</p>
<p>当然了，你也可以直接把MasterKey传入到X-Bmob-Master-Key中, 这个就可以实现在不需要提供SessionToken的情形下更新和删除用户了，但希望只在开发环境下使用，不要把MasterKey发布出去。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/users/objectId</p>
</li>
<li>
<p>method ：DELETE</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
X-Bmob-Session-Token: sessionToken
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>删除objectId为g7y9tkhB7O的用户。</p>
<pre><code>curl -X DELETE \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
    https://api2.bmob.cn/1/users/g7y9tkhB7O
</code></pre>

<h3 id="_56">查询用户<a class="headerlink" href="#_56" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>你可以一次获取多个用户，只要向用户的根URL发送一个GET请求，没有任何URL参数的话，可以简单地列出所有用户。</p>
<p>所有的对普通对象的查询选项都适用于对用户对象的查询，所以可以查看 <a href="#查询">查询</a> 部分来获取详细信息。</p>
<p>User表是一个特殊的表，专门用于存储用户对象。在浏览器端，你会看到一个User表旁边有一个小人的图标。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/users</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  {
    &quot;results&quot;: [
        {
            &quot;username&quot;: username,
            &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
            &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
            &quot;objectId&quot;: objectId,
            key1:value1,
            ...
        },
        {
            &quot;username&quot;: username,
            &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
            &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
            &quot;objectId&quot;: objectId,
            key1:value1,
            ...
        },
        ...
    ]
}
}
</code></pre>

<p><strong>例子</strong></p>
<p>获取当前用户表的所有用户信息。</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    https://api2.bmob.cn/1/users
</code></pre>

<h3 id="_57">密码重置<a class="headerlink" href="#_57" title="Permanent link">&para;</a></h3>
<p>共提供了3种方法，分别是email重置、短信验证码重置、旧密码重置。</p>
<h4 id="eamil">Eamil重置<a class="headerlink" href="#eamil" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>你可以使用这项功能，前提是用户将email与他们的账户关联起来，如果要重设密码，发送一个POST请求到 <strong>/1/requestPasswordReset</strong>, 同时在request的body部分带上email字段。</p>
<p>密码重置流程如下：</p>
<ol>
<li>用户输入他们的电子邮件，请求重置自己的密码。</li>
<li>Bmob向他们的邮箱发送一封包含特殊的密码重置连接的电子邮件，此邮件的模板可在Bmob后台中修改。</li>
<li>用户根据向导点击重置密码连接，打开一个特殊的Bmob页面，输入一个新的密码。</li>
<li>用户的密码已被重置为新输入的密码。</li>
</ol>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/requestPasswordReset</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
    &quot;email&quot;:emailAdress
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>重置用户邮箱为coolguy@iloveapps.com的用户密码。</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;email&quot;:&quot;coolguy@iloveapps.com&quot;}' \
    https://api2.bmob.cn/1/requestPasswordReset
</code></pre>

<h4 id="_58">使用短信验证码进行密码重置<a class="headerlink" href="#_58" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>如果用户有绑定了手机号码，就可以通过手机验证码短信来实现使用手机号码找回密码的功能，先调用 <a href="../../../Restful/developdoc/index.html?menukey=develop_doc&amp;key=develop_restful#请求短信验证码" title="请求短信验证码API">请求短信验证码API</a>会将验证码发送到用户手机上，用户收到验证码并输入后，调用PUT /1/resetPasswordBySmsCode/smsCode 来为用户设置新的密码。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/resetPasswordBySmsCode/smsCode</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;password&quot;: &quot;new password&quot;
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>    {&quot;msg&quot;: &quot;ok&quot;}
</code></pre>

<p><strong>例子</strong></p>
<p>以下为短信验证码重置样例。</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;password&quot;: &quot;testPass&quot;}' \
    https://api2.bmob.cn/1/resetPasswordBySmsCode/123987
</code></pre>

<h4 id="_59">提供旧密码方式安全修改用户密码<a class="headerlink" href="#_59" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>很多开发者希望让用户输入一次旧密码做一次校验，旧密码正确才可以修改为新密码，因此我们提供了一个单独的 API <strong>PUT /1/updatePassword</strong> 来安全地修改用户密码。</p>
<p><strong>注意：仍然需要传入 X-Bmob-Session-Token，也就是登录用户才可以修改自己的密码。</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/updateUserPassword/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
X-Bmob-Session-Token: sessionToken
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;oldPassword&quot;: &quot;用户的老密码&quot;,
  &quot;newPassword&quot;: &quot;用户的新密码&quot;
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;oldPassword&quot;: &quot;123&quot;,&quot;newPassword&quot;: &quot;456&quot;}' \
    https://api2.bmob.cn/1/updateUserPassword/g7y9tkhB7O
</code></pre>

<p>g7y9tkhB7O：为当前登录用户的objectId。
pnktnjyb996sj4p156gjtp4im:用户sessionToken</p>
<h3 id="_60">邮箱验证<a class="headerlink" href="#_60" title="Permanent link">&para;</a></h3>
<p>设置邮件验证是一个可选的应用设置, 这样可以对已经确认过邮件的用户提供一部分保留的体验，邮件验证功能会在用户(User)对象中加入emailVerified字段, 当一个用户的邮件被新添加或者修改过的话，emailVerified会默认被设为false，如果应用设置中开启了邮箱认证功能，<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>会对用户填写的邮箱发送一个链接, 这个链接可以把emailVerified设置为 true.</p>
<p>emailVerified 字段有 3 种状态可以考虑：</p>
<p><strong>true</strong> : 用户可以点击邮件中的链接通过<a href="http://www.bmob.cn/" title="Bmob移动后端云服务平台">Bmob</a>来验证地址，一个用户永远不会在新创建这个值的时候出现emailVerified为true。</p>
<p><strong>false</strong> : 用户(User)对象最后一次被刷新的时候, 用户并没有确认过他的邮箱地址, 如果你看到emailVerified为false的话，你可以考虑刷新 用户(User)对象。</p>
<p><strong>missing</strong> : 用户(User)对象已经被创建，但应用设置并没有开启邮件验证功能； 或者用户(User)对象没有email邮箱。</p>
<p><strong>请求描述</strong></p>
<p>发送到用户邮箱验证的邮件会在一周内失效，可以通过调用 <strong>/1/requestEmailVerify</strong> 来强制重新发送。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/requestEmailVerify</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;email&quot;:emailAddress
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{&quot;email&quot;:&quot;coolguy@iloveapps.com&quot;}' \
  https://api2.bmob.cn/1/requestEmailVerify
</code></pre>

<h3 id="_61">用户账户连接<a class="headerlink" href="#_61" title="Permanent link">&para;</a></h3>
<p>Bmob允许你连接你的用户到第三方账户服务系统，比如新浪微博和QQ，这样就允许您的用户用已经存在的第三方账户直接登录您的App。通过注册或者更新的用户信息的功能，使用 <strong>authData</strong> 字段来保存第三方服务的授权信息就可以做到。一旦用户关联了某个第三方账户，<strong>authData</strong> 将被存储到您的Bmob的用户信息里，并通过登录即可重新获取到。</p>
<p><strong>authData</strong> 是一个普通的 JSON 对象，它所要求的key根据第三方账户服务不同而不同，具体要求见下面。每种情况下，你都需要自己负责完成整个授权过程 (一般是通过 OAuth 协议，1.0 或者 2.0) 通过连接的API来获取授权信息。</p>
<p>新浪微博的 <strong>authData</strong> 内容:</p>
<pre><code>{
  &quot;authData&quot;: {
    &quot;weibo&quot;: {
      &quot;uid&quot;: &quot;123456789&quot;,
      &quot;access_token&quot;: &quot;2.00ed6eMCV9DWcBcb79e8108f8m1HdE&quot;,
      &quot;expires_in&quot;: 1564469423540
    }
  }
}
</code></pre>

<p>腾讯QQ的 <strong>authData</strong> 内容:</p>
<pre><code>{
  &quot;authData&quot;: {
    &quot;qq&quot;: {
      &quot;openid&quot;: &quot;2345CA18A5CD6255E5BA185E7BECD222&quot;,
      &quot;access_token&quot;: &quot;12345678-SM3m2avZxh5cjJmIrAfx4ZYyamdofM7IjU&quot;,
      &quot;expires_in&quot;: 1382686496
    }
  }
}
</code></pre>

<p>匿名用户 (Anonymous user) 的 authData 内容:</p>
<pre><code>{
  &quot;anonymous&quot;: {
    &quot;id&quot;: &quot;random UUID with lowercase hexadecimal digits&quot;
  }
}
</code></pre>

<h4 id="_62">注册和登录<a class="headerlink" href="#_62" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>使用一个第三方账户连接服务来注册用户并登录，同样使用POST请求/1/users，只是需要提供authData字段。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/users</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
   &quot;authData&quot;: {
       platform: {
          &quot;uid&quot;: uid,
          &quot;access_token&quot;: accessToken,
          &quot;expires_in&quot;: expiresIn
        }
    }
 }
</code></pre>

<p><strong>成功时响应</strong></p>
<p>Bmob 会校验提供的 authData 是否有效，并检查是否已经有一个用户连接了这个 authData 服务。如果已经有用户存在并连接了同一个 authData，那么Http响应头将返回 200 OK 和详细信息 (包括用户的 sessionToken):</p>
<pre><code>Status: 200 OK
Location: https://api2.bmob.cn/1/users/objectId
</code></pre>

<p>应答的 body 类似:</p>
<pre><code>{
  &quot;username&quot;: username,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToken,
  &quot;authData&quot;: {
       platform: {
          &quot;uid&quot;: uid,
          &quot;access_token&quot;: accessToken,
          &quot;expires_in&quot;: expiresIn
        }
    }
  }
}
</code></pre>

<p>如果用户还没有连接到这个帐号，则你会收到 201 Created 的应答状态码，标识新的用户已经被创建:</p>
<pre><code>Status: 201 Created
Location: https://api2.bmob.cn/1/users/objectId
</code></pre>

<p>应答内容包括 objectId,createdAt,sessionToken 以及一个自动生成的随机 username</p>
<pre><code>{
  &quot;username&quot;: username,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToken,
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，使用新浪微博账户注册或者登录用户:</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
     &quot;authData&quot;: {
       &quot;weibo&quot;: {
          &quot;uid&quot;: &quot;123456789&quot;,
          &quot;access_token&quot;: &quot;2.00ed6eMCV9DWcBcb79e8108f8m1HdE&quot;,
          &quot;expires_in&quot;: 1564469423540
        }
      }
    }' \
  https://api2.bmob.cn/1/users
</code></pre>

<h4 id="_63">连接<a class="headerlink" href="#_63" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>连接一个现有的用户到新浪微博或者腾讯QQ帐号，可以通过发送一个 PUT 请求附带 authData 字段到以上Location返回的用户URL做到。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/users/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
X-Bmob-Session-Token: sessionToken
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
   &quot;authData&quot;: {
       platform: {
          &quot;uid&quot;: uid,
          &quot;access_token&quot;: accessToken,
          &quot;expires_in&quot;: expiresIn
        }
    }
 }
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;username&quot;: username,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToken,
  &quot;authData&quot;: {
       platform: {
          &quot;uid&quot;: uid,
          &quot;access_token&quot;: accessToken,
          &quot;expires_in&quot;: expiresIn
        }
    }
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，连接一个用户到腾讯QQ帐号发起的请求类似这样:</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;authData&quot;: {
           &quot;qq&quot;: {
              &quot;openid&quot;: &quot;2345CA18A5CD6255E5BA185E7BECD222&quot;,
              &quot;access_token&quot;: &quot;12345678-SM3m2avZxh5cjJmIrAfx4ZYyamdofM7IjU&quot;,
              &quot;expires_in&quot;: 1382686496
            }
        }
      }' \
  https://api2.bmob.cn/1/users/Kc3M222J
</code></pre>

<p>完成连接后，你可以使用匹配的 authData 来认证他们。</p>
<h4 id="_64">断开连接<a class="headerlink" href="#_64" title="Permanent link">&para;</a></h4>
<p><strong>请求描述</strong></p>
<p>断开一个现有用户到某个服务，可以发送一个 PUT 请求设置 authData 中对应的服务为 null 来做到。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/users/objectId</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
X-Bmob-Session-Token: sessionToken
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
    &quot;authData&quot;: {
          platform:null
    }
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;username&quot;: username,
  &quot;createdAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;updatedAt&quot;: YYYY-mm-dd HH:ii:ss,
  &quot;objectId&quot;: objectId,
  &quot;sessionToken&quot;: sessionToken,
  &quot;authData&quot;: {
       platform: NULL
    }
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，取消新浪微博关联:</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;authData&quot;: {
          &quot;weibo&quot; : null
        }
      }' \
  https://api2.bmob.cn/1/users/Kc3M222J
</code></pre>

<h2 id="_65">文件管理<a class="headerlink" href="#_65" title="Permanent link">&para;</a></h2>
<p>Bmob的新版文件采用了cdn。</p>
<h3 id="_66">整个文件上传<a class="headerlink" href="#_66" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/2/files/fileName，可以选择BASE64加密</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<p>Content-Type 不同类型文件使用不同的值，可以参考：<a href="http://tool.oschina.net/commons">http://tool.oschina.net/commons</a></p>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: content-Type
</code></pre>

<ul>
<li>body:</li>
</ul>
<p>相应的文本或者二进制流</p>
<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>返回的主体是一个JSON对象，包含：文件名（filename）、cdn信息（cdnname）、文件地址（url）。</p>
<pre><code>{
  &quot;filename&quot;: filename,
  &quot;url&quot;: url,
  &quot;cdn&quot;:cdnname
}
</code></pre>

<p><strong>例子</strong></p>
<p>上传一个 hello.txt 文件实现方法如下（-d的值是文件内容）：</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: text/plain&quot; \
  -d 'Hello, World!' \
  https://api2.bmob.cn/2/files/hello.txt
</code></pre>

<p>上传当前文件夹下的图片 myPicture.jpg 实现方法如下（--data-binary的值是文件二进制内容）：</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: image/jpeg&quot; \
  --data-binary '@myPicture.jpg' \
  https://api2.bmob.cn/2/files/myPicture.jpg
</code></pre>

<p>返回的内容，此时使用http://bmob-cdn-24.b0.upaiyun.com/2016/04/14/9306f2e74090d668801eac8814b3f56f.jpg 即可访问。</p>
<pre><code>{
  &quot;filename&quot;: &quot;myPicture.jpg&quot;,
  &quot;url&quot;: &quot;http://bmob-cdn-24.b0.upaiyun.com/2016/04/14/9306f2e74090d668801eac8814b3f56f.jpg&quot;,
  &quot;cdn&quot;:&quot;upyun&quot;
}
</code></pre>

<p>上传完成后，你还可以把上传后的文件对象关联到某行记录中，相应的body格式为：</p>
<pre><code>{
    keyOfFile:{
    &quot;__type&quot;: &quot;File&quot;,
        &quot;group&quot;: &quot;upyun&quot;,
        &quot;filename&quot;: fileName,
        url: url
    }
}
</code></pre>

<p>例子如下：</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;score&quot;:73453, &quot;file&quot;:{
        &quot;__type&quot;: &quot;File&quot;,
        &quot;group&quot;: &quot;group1&quot;,
        &quot;filename&quot;: &quot;myPicture.jpg&quot;,
        url: &quot;http://bmob-cdn-24.b0.upaiyun.com/2016/04/14/9306f2e74090d668801eac8814b3f56f.jpg&quot;
    }}' \
https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_67">删除文件<a class="headerlink" href="#_67" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>该接口可删除已经上传的文件。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/2/files/cdnName/url ，其中cdnName是指上传文件后再body返回的cdnname,其中URL指的是上传文件后在body中返回的url除去域名之后的字符串。</p>
</li>
<li>
<p>method ：DELETE</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>如下为删除jpg文件的例子</p>
<pre><code>curl -X DELETE \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  https://api2.bmob.cn/2/files/upyun/2019/01/09/53a0ff6340b6a7b780c9031d79d8befe.png
</code></pre>

<p>在上面的例子中要删除的图片为http://bmob-cdn-1614.b0.upaiyun.com/2019/01/09/53a0ff6340b6a7b780c9031d79d8befe.png，截取这个url中的“2019/01/09/53a0ff6340b6a7b780c9031d79d8befe.png”拼上前面的参数"https://api2.bmob.cn/2/files/upyun/"，就能得到删除时所使用的url：https://api2.bmob.cn/2/files/upyun/2019/01/09/53a0ff6340b6a7b780c9031d79d8befe.png</p>
<p>如果域名是用bmobcloud.com的（例如：https://bmob-cdn-10.bmobcloud.com/2019/01/09/08d7522240e650f68035e4b79077fe82.png），根据上面的规则，也同样得到 https://api2.bmob.cn/2/files/upyun/2019/01/09/08d7522240e650f68035e4b79077fe82.png</p>
<p><strong>删除文件不会删除文件关联的行记录中的文件列的值，需要自行通过更新行来删除关联。</strong></p>
<h3 id="_68">批量删除文件<a class="headerlink" href="#_68" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong>
该接口可批量删除已经上传的文件。此操作不可逆，已经删除成功的文件不可恢复。</p>
<p><strong>请求</strong></p>
<ul>
<li>url :https://api2.bmob.cn/2/cdnBatchDelete</li>
<li>method : POST</li>
<li>header:</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
Content-Type: application/json
</code></pre>

<ul>
<li>body
cdnname为上传文件是返回的cdnname，url1，url2为上传时返回的url除去域名后的字符串。</li>
</ul>
<pre><code>{
  &quot;cdnname&quot;:[&quot;url1&quot;,&quot;url2&quot;]
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>失败时响应</strong>
cdnname为删除失败的cdn名称，url1，url2为删除失败的url地址。</p>
<pre><code>{
  &quot;code&quot;: 154,
  &quot;error&quot;: &quot;error info&quot;,
  &quot;fail&quot;: {
    &quot;cdnname&quot;: [
      &quot;url1&quot;,
      &quot;url2&quot;
    ]
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>如下为删除上传例子中的jpg文件</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
   {
    &quot;upyun&quot;:[&quot;2016/04/14/9306f2e74090d668801eac8814b3f56f.jpg&quot;,&quot;2016/04/14/ycf2f2e74090d668801eac88145523f.jpg&quot;],
}
}'\
  https://api2.bmob.cn/2/cdnBatchDelete
</code></pre>

<p><strong>删除文件不会删除文件关联的行记录中的文件列的值，需要自行通过更新行来删除关联。</strong></p>
<h2 id="acl_1">ACL和角色<a class="headerlink" href="#acl_1" title="Permanent link">&para;</a></h2>
<p>数据安全是软件系统中最重要的组成部分，为了更好的保护应用数据的安全，Bmob在软件架构层面提供了应用层次、表层次、ACL（Access Control List：访问控制列表）、角色管理（Role）四种不同粒度的权限控制的方式，确保用户数据的安全（详细请查看<a href="http://docs.bmob.cn/other/Other/n_datasafety/doc/index.html">Bmob数据与安全页面</a>，了解Bmob如何保护数据安全）。</p>
<p>其中，最灵活的方法是通过ACL和角色，它的思路是每一条数据有一个用户和角色的列表，以及这些用户和角色拥有什么样的许可权限。</p>
<p>大多数应用程序需要对不同的数据进行灵活的访问和控制，这就可以使用Bmob提供的ACL模式来实现。例如：</p>
<ul>
<li>对于私有数据，读写权限可以只局限于数据的所有者。</li>
<li>对于一个论坛，会员和版主有写的权限，一般的游客只有读的权限。</li>
<li>对于日志数据只有开发者才能够访问，ACL可以拒绝所有的访问权限。</li>
<li>属于一个被授权的用户或者开发者所创建的数据，可以有公共的读的权限，但是写入权限仅限于管理者角色。</li>
<li>一个用户发送给另外一个用户的消息，可以只给这些用户赋予读写的权限。</li>
</ul>
<h3 id="acl_2">ACL的格式<a class="headerlink" href="#acl_2" title="Permanent link">&para;</a></h3>
<p>在Bmob中，ACL是按JSON对象格式（key-value）来表示的。这个JSON对象的key是objectId（用户表某个用户对应的objectId）或者是 *(表示公共的访问权限)，ACL 的值是 "读和写的权限", 这个JSON对象的key总是权限名, 而这些key的值总是 true。</p>
<p>如果您想让一个 id 为 "Kc3M222k" 的用户有读和写一条数据的权限, 而且这个数据应该可以被全部人读取的话，这个ACL的表达方式如下，只要将该值设置到对应数据的ACL字段中即可：</p>
<pre><code>{
  &quot;Kc3M222k&quot;: {
    &quot;read&quot;: true,
    &quot;write&quot;: true
  },
  &quot;*&quot;: {
    &quot;read&quot;: true
  }
}
</code></pre>

<h3 id="_69">角色和相关操作<a class="headerlink" href="#_69" title="Permanent link">&para;</a></h3>
<p>在很多情况下，你需要定义一些用户具有某种相同的数据操作权限，而另外一群用户具有另外一种相同的数据操作权限，这时你就可以使用到Bmob的角色（对应Bmob在Web提供的Role表、SDK中的BmobRole类）功能，设置不同的用户组不同的操作权限。角色表有三个特殊字段：</p>
<p><code>name</code> : 必须字段，表示角色名称,而且只允许被设置一次（命名必须由字母, 空格, 减号或者下划线构成）；</p>
<p><code>users</code> :一个指向一系列用户的关系, 这些用户会继承角色的权限；</p>
<p><code>roles</code> : 一个指向一系列子角色的关系, 这些子关系会继承父角色所有的权限。</p>
<p>而创建角色、更新角色、删除角色本质就是对_Role表进行操作，因为该表是固定的，所以我们将请求的URL设置为https://api2.bmob.cn/1/roles，具体操作如下。_Role表中含 <code>users</code>和 <code>roles</code>字段，其中 <code>users</code> 字段指向的是 <code>_User</code> 表，在该字段下的用户记录具备该角色的读写权限，而 <code>roles</code> 字段指向的是 <code>_Role</code> 表，在该字段下的角色记录都将继承该角色的权限。</p>
<h4 id="_70">创建角色<a class="headerlink" href="#_70" title="Permanent link">&para;</a></h4>
<p>创建一个新角色的方法如下（固定POST数据到https://api2.bmob.cn/1/roles中，且必须提供 <code>name</code> 字段）：</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;name&quot;: &quot;Moderators&quot;,
        &quot;ACL&quot;: {
          &quot;*&quot;: {
            &quot;read&quot;: true
          }
        }
      }' \
  https://api2.bmob.cn/1/roles
</code></pre>

<p>如果你要创建一个包括了“用户和子角色”的角色，实现方式如下：</p>
<pre><code>curl -X POST \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;name&quot;: &quot;Moderators&quot;,
        &quot;ACL&quot;: {
          &quot;*&quot;: {
            &quot;read&quot;: true
          }
        },
        &quot;roles&quot;: {
          &quot;__op&quot;: &quot;AddRelation&quot;,
          &quot;objects&quot;: [
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_Role&quot;,
              &quot;objectId&quot;: &quot;Fe441wZ5&quot;
            }
          ]
        },
        &quot;users&quot;: {
          &quot;__op&quot;: &quot;AddRelation&quot;,
          &quot;objects&quot;: [
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_User&quot;,
              &quot;objectId&quot;: &quot;Kc3M222k&quot;
            }
          ]
        }
      }' \
  https://api2.bmob.cn/1/roles
</code></pre>

<p>当创建成功后返回HTTP如下：</p>
<pre><code>Status: 201 Created
Location: https://api2.bmob.cn/1/roles/51e3812D
</code></pre>

<h4 id="_71">获取角色<a class="headerlink" href="#_71" title="Permanent link">&para;</a></h4>
<p>获取角色对象的方法如下：</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  https://api2.bmob.cn/1/roles/51e3812D
</code></pre>

<p>响应结果如下：</p>
<pre><code>{
  &quot;createdAt&quot;: &quot;2012-04-28 17:41:09&quot;,
  &quot;objectId&quot;: &quot;51e3812D&quot;,
  &quot;updatedAt&quot;: &quot;2012-04-28 17:41:09&quot;,
  &quot;ACL&quot;: {
    &quot;*&quot;: {
      &quot;read&quot;: true
    },
    &quot;role:Administrators&quot;: {
      &quot;write&quot;: true
    }
  },
  &quot;name&quot;: &quot;Moderators&quot;
}
</code></pre>

<p>注意 users 和 roles 关系无法在 JSON 结果中看到, 您需要使用 $relatedTo 操作符来查询。</p>
<h4 id="_72">更新角色<a class="headerlink" href="#_72" title="Permanent link">&para;</a></h4>
<p>更新角色时，一个很重要的一点是： <code>name</code> 字段不可以更改。添加和删除 <code>users</code> 和 <code>roles</code> 可以通过使用 AddRelation 和 RemoveRelation 操作符进行。</p>
<p>如给 "Moderators" 角色增加 2 个用户，实现如下:</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;users&quot;: {
          &quot;__op&quot;: &quot;AddRelation&quot;,
          &quot;objects&quot;: [
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_User&quot;,
              &quot;objectId&quot;: &quot;eba635d9&quot;
            },
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_User&quot;,
              &quot;objectId&quot;: &quot;51dfb8bd&quot;
            }
          ]
        }
      }' \
  https://api2.bmob.cn/1/roles/51e3812D
</code></pre>

<p>删除 "Moderrators" 的一个子角色的实现如下：</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;roles&quot;: {
          &quot;__op&quot;: &quot;RemoveRelation&quot;,
          &quot;objects&quot;: [
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_Role&quot;,
              &quot;objectId&quot;: &quot;eba635d9&quot;
            }
          ]
        }
      }' \
  https://api2.bmob.cn/1/roles/51e3812D
</code></pre>

<h4 id="_73">删除角色<a class="headerlink" href="#_73" title="Permanent link">&para;</a></h4>
<p>删除角色这里有一个需要注意的是：需要传入 X-Bmob-Session-Token ，即对这条数据有操作权限的用户SessionToken。实现如下：</p>
<pre><code>curl -X DELETE \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;X-Bmob-Session-Token: pnktnjyb996sj4p156gjtp4im&quot; \
  https://api2.bmob.cn/1/roles/51e3812D
</code></pre>

<h4 id="_74">角色的使用<a class="headerlink" href="#_74" title="Permanent link">&para;</a></h4>
<p>设置一条数据的角色权限，需要在ACL中把Key的名字设置为 “<code>role:</code> + 角色名称” 。如限制一条数据可以被在 "Members" 里的任何人读到, 而且可以被它的创建者（objectId为<code>f1766d0b42</code>）和任何有 "Moderators" 角色的人所修改, 实现方式如下:</p>
<pre><code>{
  &quot;f1766d0b42&quot;: {
    &quot;write&quot;: true
  },
  &quot;role:Members&quot;: {
    &quot;read&quot;: true
  },
  &quot;role:Moderators&quot;: {
    &quot;write&quot;: true
  }
}
</code></pre>

<p>如果这个用户和 "Moderators" 本身就是 "Members" 的子角色和用户，那么，您不必为创建的用户和 "Moderators" 指定读的权限，因为它们都会继承授予 "Members" 的权限。</p>
<h4 id="_75">角色的继承<a class="headerlink" href="#_75" title="Permanent link">&para;</a></h4>
<p>一个角色可以包含另一个，可以为 2 个角色建立一个父-子关系。 这个关系的结果就是任何被授予父角色的权限隐含地被授予子角色。</p>
<p>这样的关系类型通常在用户管理的内容类的应用上比较常见, 比如在论坛中，有一些少数的用户是 "管理员（Administartors）", 有最高的权限，可以调整系统设置、 创建新的论坛等等。 另一类用户是 "版主（Moderators）"，他们可以对用户发帖的内容进行管理。可见，任何有管理员权限的人都应该有版主的权限。为建立起这种关系, 您应该把 "Administartors" 的角色设置为 "Moderators" 的子角色, 具体来说就是把 "Administrators" 这个角色加入 "Moderators" 对象的 roles 关系之中，实现如下：</p>
<pre><code class="java">
curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{
        &quot;roles&quot;: {
          &quot;__op&quot;: &quot;AddRelation&quot;,
          &quot;objects&quot;: [
            {
              &quot;__type&quot;: &quot;Pointer&quot;,
              &quot;className&quot;: &quot;_Role&quot;,
              &quot;objectId&quot;: &quot;&lt;AdministratorsRoleObjectId&gt;&quot;
            }
          ]
        }
      }' \
  https://api2.bmob.cn/1/roles/&lt;ModeratorsRoleObjectId&gt;
</code></pre>

<h2 id="_76">地理位置<a class="headerlink" href="#_76" title="Permanent link">&para;</a></h2>
<p>Bmob允许用户根据地球的经度和纬度坐标进行基于地理位置的信息查询。你可以在查询中添加一个GeoPoint的对象查询。你可以实现轻松查找出离当前用户最接近的信息或地点的功能。</p>
<h3 id="_77">创建地理位置对象<a class="headerlink" href="#_77" title="Permanent link">&para;</a></h3>
<p>在表中添加一个地理位置的列，只需要在对应列值满足以下格式即可。</p>
<pre><code>{
  key : {
    &quot;__type&quot;: &quot;GeoPoint&quot;,
    &quot;latitude&quot;: latitudeValue,
    &quot;longitude&quot;: longitude
  }
}
</code></pre>

<p>例如，如果需要在 <code>GameScore</code> 的特定对象中加上地理位置，其请求如下：</p>
<pre><code>curl -X PUT \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
  -H &quot;Content-Type: application/json&quot; \
  -d '{&quot;location&quot;:{
            &quot;__type&quot;: &quot;GeoPoint&quot;,
            &quot;latitude&quot;: 50.934755,
            &quot;longitude&quot;: 24.52065
        }}' \
  https://api2.bmob.cn/1/classes/GameScore/e1kXT22L
</code></pre>

<h3 id="_78">查询地理位置信息<a class="headerlink" href="#_78" title="Permanent link">&para;</a></h3>
<p>现在你有一系列的对象对应的地理坐标，如果能发现哪些对象离指定的点近就好了，这可以通过GeoPoint数据类型加上在查询中使用$nearSphere做到。查询的 <code>where</code> 参数值格式如下。</p>
<pre><code>{
  key: {
    &quot;$nearSphere&quot;: {
      &quot;__type&quot;: &quot;GeoPoint&quot;,
      &quot;latitude&quot;: latitudeValue,
      &quot;longitude&quot;: longitudeValue
    }
  }
}
</code></pre>

<p>例如，获取离用户最近的10个地点应该看起来像下面这个样子</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'limit=10' \
    --data-urlencode 'where={
    &quot;location&quot;: {
        &quot;$nearSphere&quot;: {
            &quot;__type&quot;: &quot;GeoPoint&quot;,
            &quot;latitude&quot;: 30.0,
            &quot;longitude&quot;: -20.0
        }
      }
    }' \
    https://api2.bmob.cn/1/classes/PlaceObject
</code></pre>

<p>这操作会按离纬度30.0，经度-20.0的距离排序返回一系列的结果，第一个就是最近的对象。(注意如果一个特定的order参数是给定了的话，它会覆盖按距离排序的结果)，例如，下面是两个上面的查询操作返回的结果：</p>
<pre><code>{
    &quot;results&quot;: [
    {
        &quot;location&quot;: {
             &quot;__type&quot;: &quot;GeoPoint&quot;,
            &quot;latitude&quot;: 40.0,
            &quot;longitude&quot;: -30.0
        },
        &quot;updatedAt&quot;: &quot;2011-12-06 22:36:04&quot;,
        &quot;createdAt&quot;: &quot;2011-12-06 22:36:04&quot;,
        &quot;objectId&quot;: &quot;e1kXT22L&quot;
        },
        {
        &quot;location&quot;: {
             &quot;__type&quot;: &quot;GeoPoint&quot;,
            &quot;latitude&quot;: 60.0,
            &quot;longitude&quot;: -20.0
        },
        &quot;updatedAt&quot;: &quot;2011-12-06 22:36:26&quot;,
        &quot;createdAt&quot;: &quot;2011-12-06 22:36:26&quot;,
        &quot;objectId&quot;: &quot;51e3a2a8e4b015ead4d95dd9&quot;
        }
    ]
}
</code></pre>

<p>为了限定搜索的最大距离范围，需要加入 <code>$maxDistanceInMiles(英里)</code> 和 <code>$maxDistanceInKilometers(公里d)</code>或者 <code>$maxDistanceInRadians(弧度)</code> 参数来限定，如果不加，则默认是100KM的半径。比如要找的半径在10公里内的话:</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={
        &quot;location&quot;: {
            &quot;$nearSphere&quot;: {
                &quot;__type&quot;: &quot;GeoPoint&quot;,
                &quot;latitude&quot;: 30.0,
                &quot;longitude&quot;: -20.0
            },
        &quot;$maxDistanceInKilometers&quot;: 10.0
        }
    }' \
    https://api2.bmob.cn/1/classes/PlaceObject
</code></pre>

<p>同样作查询寻找在一个特定的范围里面的对象也是可以的，为了找到在一个矩形区域里的对象，按下面的格式加入一个约束 <code>{"$within": {"$box": [southwestGeoPoint, northeastGeoPoint]}}</code>：</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot; \
    -G \
    --data-urlencode 'where={
        &quot;location&quot;: {
            &quot;$within&quot;: {
                &quot;$box&quot;: [
                    {
                        &quot;__type&quot;: &quot;GeoPoint&quot;,
                        &quot;latitude&quot;: 37.71,
                        &quot;longitude&quot;: -122.53
                    },
                    {
                        &quot;__type&quot;: &quot;GeoPoint&quot;,
                        &quot;latitude&quot;: 30.82,
                        &quot;longitude&quot;: -122.37
                    }
                ]
            }
        }
    }' \
    https://api2.bmob.cn/1/classes/PizzaPlaceObject
</code></pre>

<p><strong>注意事项</strong></p>
<p>关于地理位置的有一些问题是值得留意的:</p>
<ol>
<li>每一个表<code>只能</code>一个地理位置列，每一个对象<code>只能</code>有一个索引指向一个GeoPoint对象</li>
<li>GeoPoint的点不能超过规定的范围。<code>纬度的范围</code>应该是在<code>-90.0到90.0</code>之间。<code>经度的范围</code>应该是在<code>-180.0到180.0</code>之间。如果您添加的经纬度超出了以上范围，将导致程序错误。</li>
<li>删除文件不会删除文件关联的行记录中的文件列的值，需要自行通过更新行来删除关联。</li>
<li>如果不加任何距离范围限制，则默认是100公里的半径范围。</li>
</ol>
<h2 id="app_1">app服务<a class="headerlink" href="#app_1" title="Permanent link">&para;</a></h2>
<p>通过app REST API api，你可以查看，创建或编辑你的app，在用户管理后台也实现了这样的功能。通过验证你的bmob email账号和密码，你可以获取所有的app信息，创建一个新的app或者修改旧的app的信息。</p>
<p>app REST API api的验证流程和其它REST API api有点不一样。在验证的时候，不是验证你的app key，而是验证账号的登录信息。头部 <strong>X-Bmob-Email</strong> 代表登录用的email，头部 <strong>X-Bmob-Password</strong> 代表登录用的密码。</p>
<h3 id="app_2">获取app信息<a class="headerlink" href="#app_2" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>可以获取一个账号下所有app的信息或者某个app的信息，如下。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/apps （获取所有app信息） https://api2.bmob.cn/1/apps/Your Application ID（获取特定app信息）</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Email: Your Account Email
X-Bmob-Password: Your Account Password
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>请求所有应用信息的body结构如下：</p>
<pre><code>{
  &quot;results&quot;: [
        {
          &quot;appName&quot;: appName,
          &quot;applicationId&quot;: app Id,
          &quot;restKey&quot;: $estful Key,
          &quot;masterKey&quot;: master Key,
          &quot;accessKey&quot;: access Key,
          &quot;secretKey&quot;: secret Key,
          &quot;status&quot;: status (app 是否可用，0表示不可用，1表示可用),
          &quot;notAllowedCreateTable&quot;: isAllowedCreateTable(是否允许通过api建表，0表示允许，1表示不允许)
        },
        {
              &quot;appName&quot;: appName,
              &quot;applicationId&quot;: app Id,
              &quot;restKey&quot;: $estful Key,
              &quot;masterKey&quot;: master Key,
              &quot;accessKey&quot;: access Key,
              &quot;secretKey&quot;: secret Key,
              &quot;status&quot;: status (app 是否可用，0表示不可用，1表示可用),
              &quot;notAllowedCreateTable&quot;: isAllowedCreateTable(是否允许通过api建表，0表示允许，1表示不允许)
         },
         ...
  ]
}
</code></pre>

<p>请求单个应用信息的body结构如下：</p>
<pre><code>{
  &quot;appName&quot;: appName,
  &quot;applicationId&quot;: app Id,
  &quot;restKey&quot;: $estful Key,
  &quot;masterKey&quot;: master Key,
  &quot;accessKey&quot;: access Key,
  &quot;secretKey&quot;: secret Key,
  &quot;status&quot;: status (app 是否可用，0表示不可用，1表示可用),
  &quot;notAllowedCreateTable&quot;: isAllowedCreateTable(是否允许通过api建表，0表示允许，1表示不允许)
}
</code></pre>

<h3 id="app_3">创建新的app<a class="headerlink" href="#app_3" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>该请求接口可以动态创建一个应用。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/apps</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Email: Your Account Email
X-Bmob-Password: Your Account Password
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;appName&quot; : appName,
  &quot;status&quot;: status,
  &quot;notAllowedCreateTable&quot;: value
}
</code></pre>

<table>
<thead>
<tr>
<th align="center">参数名</th>
<th align="center">参数用途</th>
<th align="center">取值范围</th>
<th align="center">是否必须要填</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">appName</td>
<td align="center">app的名称</td>
<td align="center">少于30个字符</td>
<td align="center">是</td>
</tr>
<tr>
<td align="center">status</td>
<td align="center">app是否可用</td>
<td align="center">0：表示禁用，1：表示可用</td>
<td align="center">否</td>
</tr>
<tr>
<td align="center">notAllowedCreateTable</td>
<td align="center">是否允许通过api创建表</td>
<td align="center">0：表示允许创建表，1：表示不允许创建表</td>
<td align="center">否</td>
</tr>
</tbody>
</table>
<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;appName&quot;: appName,
  &quot;applicationId&quot;: app Id,
  &quot;restKey&quot;: $estful Key,
  &quot;masterKey&quot;: master Key,
  &quot;accessKey&quot;: access Key,
  &quot;secretKey&quot;: secret Key,
  &quot;status&quot;: status (app 是否可用，0表示不可用，1表示可用),
  &quot;notAllowedCreateTable&quot;: isAllowedCreateTable(是否允许通过api建表，0表示允许，1表示不允许)
}
</code></pre>

<p><strong>例子</strong></p>
<p>下面是一个创建app的例子</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Email: Your Account Email&quot; \
    -H &quot;X-Bmob-Password: Your Account Password&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;appName&quot;:&quot;myapp&quot;,&quot;status&quot;:1,&quot;notAllowedCreateTable&quot;:0}' \
    https://api2.bmob.cn/1/apps
</code></pre>

<h3 id="app_4">修改app信息<a class="headerlink" href="#app_4" title="Permanent link">&para;</a></h3>
<p>修改app信息与添加app相似，只是请求URL修改为 https://api2.bmob.cn/1/apps/appId，并且使用 PUT方法即可，其中body里为需要修改的信息，参见下表：</p>
<p>通过使用PUT 方法，可以修改app的信息，修改app信息时支持如下的参数：</p>
<table>
<thead>
<tr>
<th align="center">参数名</th>
<th align="center">参数用途</th>
<th align="center">取值范围</th>
<th align="center">是否必须要填</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">appName</td>
<td align="center">app的名称</td>
<td align="center">少于30个字符</td>
<td align="center">否</td>
</tr>
<tr>
<td align="center">status</td>
<td align="center">app是否可用</td>
<td align="center">0：表示禁用，1：表示可用</td>
<td align="center">否</td>
</tr>
<tr>
<td align="center">notAllowedCreateTable</td>
<td align="center">是否允许通过api创建表</td>
<td align="center">0：表示允许创建表，1：表示不允许创建表</td>
<td align="center">否</td>
</tr>
</tbody>
</table>
<p>下面是修改app信息的例子</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Email: Your Account Email&quot; \
    -H &quot;X-Bmob-Password: Your Account Password&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '{&quot;appName&quot;:&quot;myapp&quot;,&quot;status&quot;:1,&quot;notAllowedCreateTable&quot;:0}' \
    https://api2.bmob.cn/1/apps/f6fe8d5ab8a7909a3c6f6a7a0adb9550
</code></pre>

<h2 id="_79">数据表<a class="headerlink" href="#_79" title="Permanent link">&para;</a></h2>
<p>通过数据表的REST API api，你可以查看，创建或编辑你的表结构，在用户管理后台的数据浏览页面也实现了这样的功能。</p>
<p>注意，调用数据表相关的api，必须指定Master Key。</p>
<h3 id="app_5">获取app表的信息<a class="headerlink" href="#app_5" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>可获取所有表的结构或者是特定某张表的结构</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/schemas 或者 https://api2.bmob.cn/1/schemas/tableName(获取特定表)</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-Master-Key: Your Master Key
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>获取所有表结构：</p>
<pre><code>{
  &quot;results&quot;: [
          {
          &quot;className&quot;: tableName1,
          &quot;fields&quot;: {
            key1: {
              &quot;type&quot;: typeOfKey1
              &quot;targetClass&quot;:tableName（Pointer及Relation类型）
            },
            key2: {
              &quot;type&quot;: typeOfKey2
              &quot;targetClass&quot;:tableName（Pointer及Relation类型）
            },
            ...
            }
          }
        },
        {
          &quot;className&quot;: tableName2,
          &quot;fields&quot;: {
            key1: {
              &quot;type&quot;: typeOfKey1
              &quot;targetClass&quot;:tableName（Pointer及Relation类型）
            },
            key2: {
              &quot;type&quot;: typeOfKey2
              &quot;targetClass&quot;:tableName（Pointer及Relation类型）
            },
            ...
            }
          }
        },
        ...
    ]
}
</code></pre>

<p>获取特定表结构</p>
<pre><code>{
  &quot;className&quot;: tableName,
  &quot;fields&quot;: {
    key1: {
      &quot;type&quot;: typeOfKey1
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    key2: {
      &quot;type&quot;: typeOfKey2
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    ...
    }
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>例如，想要获取 <code>GameScore</code> 的表结构可使用以下请求。</p>
<pre><code>curl -X GET \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-Master-Key: Your Master Key&quot; \
    https://api2.bmob.cn/1/schemas/GameScore
</code></pre>

<p>返回的body如下：</p>
<pre><code>{
  &quot;className&quot;: &quot;GameScore&quot;,
  &quot;fields&quot;: {
    &quot;ACL&quot;: {
      &quot;type&quot;: &quot;Object&quot;
    },
    &quot;createdAt&quot;: {
      &quot;type&quot;: &quot;Date&quot;
    },
    &quot;location&quot;: {
      &quot;type&quot;: &quot;Geo&quot;
    },
    &quot;name&quot;: {
      &quot;type&quot;: &quot;String&quot;
    },
    &quot;objectId&quot;: {
      &quot;type&quot;: &quot;String&quot;
    },
    &quot;updatedAt&quot;: {
      &quot;type&quot;: &quot;Date&quot;
    }
  }
}
</code></pre>

<h3 id="_80">表支持的数据类型<a class="headerlink" href="#_80" title="Permanent link">&para;</a></h3>
<p>Bmob的表含有String、Number、Bool、Date、File、Geo、Array、Object、Pointer以及Relation类型。</p>
<h3 id="_81">创建一个表<a class="headerlink" href="#_81" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p>可通过该接口创建一个表</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ： https://api2.bmob.cn/1/schemas/TableName</p>
</li>
<li>
<p>method ：POST</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-Master-Key: Your Master Key
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>{
  &quot;className&quot;: tableName,
  &quot;fields&quot;: {
    key1: {
      &quot;type&quot;: typeOfKey1
      &quot;targetClass&quot;:tableName（Pointer及Relation类型需要填）
    },
    key2: {
      &quot;type&quot;: typeOfKey2
      &quot;targetClass&quot;:tableName（Pointer及Relation类型需要填）
    },
    ...
    }
  }
}
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;className&quot;: tableName,
  &quot;fields&quot;: {
    key1: {
      &quot;type&quot;: typeOfKey1
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    key2: {
      &quot;type&quot;: typeOfKey2
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    ...
    }
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>如创建表“City”，并添加字段 <code>name</code> 和 <code>visiter</code> （指向_User）</p>
<pre><code>curl -X POST \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-Master-Key: Your Master Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '
        {
          &quot;className&quot;: &quot;City&quot;,
          &quot;fields&quot;: {
                &quot;name&quot;: {
                  &quot;type&quot;: &quot;String&quot;
                },
                &quot;visiter&quot;: {
                  &quot;type&quot;: &quot;Pointer&quot;,
                  &quot;targetClass&quot;:&quot;_User&quot;
                }
          }
        }' \
  https://api2.bmob.cn/1/schemas/City
</code></pre>

<h3 id="_82">修改表的结构<a class="headerlink" href="#_82" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/schemas/tableName</p>
</li>
<li>
<p>method ：PUT</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-Master-Key: Your Master Key
</code></pre>

<ul>
<li>body:</li>
</ul>
<pre><code>  {
      &quot;className&quot;: tableName,
      &quot;fields&quot;: {
        key1: {
          &quot;type&quot;: &quot;String&quot;(添加字段)
        },
        key2: {
          &quot;type&quot;: &quot;String&quot;,
          &quot;__op&quot;: &quot;Delete&quot; (删除字段)
        }
      }
 }
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<p>返回的是修改后的表结构</p>
<pre><code>{
  &quot;className&quot;: tableName,
  &quot;fields&quot;: {
    key1: {
      &quot;type&quot;: typeOfKey1
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    key2: {
      &quot;type&quot;: typeOfKey2
      &quot;targetClass&quot;:tableName（Pointer及Relation类型）
    },
    ...
    }
  }
}
</code></pre>

<p><strong>例子</strong></p>
<p>在表“City”中添加字段“name”</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-Master-Key: Your Master Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '
    {
      &quot;className&quot;: &quot;City&quot;,
      &quot;fields&quot;: {
        &quot;name&quot;: {
          &quot;type&quot;: &quot;String&quot;
        }
      }
    }' \
  https://api2.bmob.cn/1/schemas/City

</code></pre>

<p>在表“City”中删除字段“name”</p>
<pre><code>curl -X PUT \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-Master-Key: Your Master Key&quot; \
    -H &quot;Content-Type: application/json&quot; \
    -d '
    {
      &quot;className&quot;: &quot;City&quot;,
      &quot;fields&quot;: {
        &quot;name&quot;: {
          &quot;type&quot;: &quot;String&quot;,
          &quot;__op&quot;: &quot;Delete&quot;
        }
      }
    }' \
  https://api2.bmob.cn/1/schemas/City
</code></pre>

<h3 id="_83">删除表<a class="headerlink" href="#_83" title="Permanent link">&para;</a></h3>
<p><strong>请求描述</strong></p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/schemas/tableName</p>
</li>
<li>
<p>method ：DELETE</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-Master-Key: Your Master Key
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;msg&quot;: &quot;ok&quot;
}
</code></pre>

<p><strong>例子</strong></p>
<p>删除City表</p>
<pre><code>curl -X DELETE \
    -H &quot;X-Bmob-Application-Id: Your Application ID&quot; \
    -H &quot;X-Bmob-Master-Key: Your Master Key&quot; \
  https://api2.bmob.cn/1/schemas/City
</code></pre>

<h2 id="_84">获取服务器时间<a class="headerlink" href="#_84" title="Permanent link">&para;</a></h2>
<p><strong>请求描述</strong></p>
<p>有时，app需要获取服务器的时间，可使用该请求。</p>
<p><strong>请求</strong></p>
<ul>
<li>
<p>url ：https://api2.bmob.cn/1/timestamp</p>
</li>
<li>
<p>method ：GET</p>
</li>
<li>
<p>header:</p>
</li>
</ul>
<pre><code>X-Bmob-Application-Id: Your Application ID
X-Bmob-REST-API-Key: Your REST API Key
</code></pre>

<p><strong>成功时响应</strong></p>
<ul>
<li>
<p>status: 200 OK</p>
</li>
<li>
<p>body:</p>
</li>
</ul>
<pre><code>{
  &quot;timestamp&quot;: timestamp,
  &quot;datetime&quot;: YYYY-mm-dd HH:ii:ss(北京时间)
}
</code></pre>

<p><strong>例子</strong></p>
<p>以下是一个请求样例，</p>
<pre><code>curl -X GET \
  -H &quot;X-Bmob-Application-Id: Your Application ID&quot;          \
  -H &quot;X-Bmob-REST-API-Key: Your REST API Key&quot;        \
  https://api2.bmob.cn/1/timestamp
</code></pre>

<p>返回参数如下：</p>
<pre><code>{&quot;timestamp&quot;:1437531770,&quot;datetime&quot;:&quot;2015-07-22 10:22:50&quot;}
</code></pre>

<p>timestamp为时间戳，datetime为格式化的日期。</p>
<h2 id="_85">错误码<a class="headerlink" href="#_85" title="Permanent link">&para;</a></h2>
<p>参照<a href="../../../other/error_code/#restapi">所有平台错误码列表</a> 中的REST API部分。</p>
                </div>
            </div>
        </div>

        
            <script>var base_url = '../../..';</script>
            <script src="../../../js/jquery-1.10.2.min.js"></script>
            <script src="../../../js/bootstrap-3.0.3.min.js"></script>
            <script src="../../../js/highlight.pack.js"></script>
            <script src="../../../js/main.js"></script>
            <script src="../../../js/base.js"></script>

        <div id="go-top"><i class="fa fa-chevron-up"></i></div>
        <a href="https://docs.bmob.cn/data/Android/a_faststart/doc/index.html" id="back" target="_blank">返回 <br> 旧版</a>
    </body>

</html>